- Notifications
You must be signed in to change notification settings - Fork31
A second-generation custom server for LittleBigPlanet that focuses on quality of life features and improving user experience.
License
LittleBigRefresh/Refresh
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
A second-generation custom server for LittleBigPlanet that focuses on ease of use and reliability. 🌎🎮
Warning
While Refresh is stable and mostly secure in our testing, we cannot make any guarantees about anything. You use Refresh at YOUR OWN RISK.Refresh is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.See theGNU Affero General Public License for more details.
Note
Refresh is free software: you can redistribute it and/or modify it under the terms of theGNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
Anyway, with the legal disclaimers out of the way...
- Find the latest release
- Download the artifact for your OS, extract it somewhere most convenient to you, and run it!
- Optionally, run through configuring
bunkum.jsonandrefreshGameServer.jsonto your liking. These files contain settings like instance name, announce text, whether or not registration is enabled, and more.
To update, you can simply repeat this process, overwriting the previous files.
- Find the latest release or checkout the source code
- Install Docker if not already installed
- Verify that the container works with your shell attached:
docker compose up - If Refresh starts successfully, start the docker container in the background:
docker compose up --detach
To update, you simply run agit pull to pull the latest changes,and then rundocker compose up --build to rebuild the image.
If you would like refresh-web, head tohere to view the latest artifacts, then grab them.Once you've downloaded the artifact, browse to your data folder and create a folder called 'web' and extract the zip you've just downloaded to that folder.
Refresh isn't perfect, so it's not exactly uncommon to run into bugs. If you'd like, you cancreate an issue here on GitHub or join ourDiscord for support.
Wherever you choose to post, be sure to include details about how to trigger the bug, text logs (not screenshots!), your environment, the bug's symptoms, and anything else you might find relevant to the bug.
When dealing with authentication problems, it can be particularly helpful to check your user's notifications (the bell on the web interface will take you there) as authentication errors are logged here.
To contribute to Refresh, it may be helpful to refer to ourcontributing guide to get a basic development environment set up. If you're a pro, feel free to skip this as it's just your bog-standard setting up C# guide.
However, something important for all those involved: we also serve additional documentation relating to Refresh, Bunkum, and LittleBigPlanet in general in ourDocs repo.
Made with 💙 for the LittleBigPlanet community
About
A second-generation custom server for LittleBigPlanet that focuses on quality of life features and improving user experience.