ennuo / refresh

A second-generation custom server for LittleBigPlanet that focuses on ease of use and reliability.

🌎 Refresh

A second-generation custom server for LittleBigPlanet that focuses on ease of use and reliability. 🌎🎮

💻 Running

📜 Legalities

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 the GNU Affero General Public License for more details.

Note

Refresh is free software: you can redistribute it and/or modify it under the terms of the GNU 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...

📖 Instructions

From Release

1. Find the latest release
2. Download the artifact for your OS, extract it somewhere most convenient to you, and run it!
3. Optionally, run through configuring bunkum.json and refreshGameServer.json to 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.

Using Docker (compose)

1. Find the latest release or checkout the source code
2. Install Docker if not already installed
3. Verify that the container works with your shell attached: docker compose up
4. If Refresh starts successfully, start the docker container in the background: docker compose up --detach

To update, you simply run a git pull to pull the latest changes, and then run docker compose up --build to rebuild the image.

If you would like refresh-web, head to here 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.

🔥 It's on fire! What do I do?

Refresh isn't perfect, so it's not exactly uncommon to run into bugs. If you'd like, you can create an issue here on GitHub or join our Discord 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.

🔧 Building & Contributing

To contribute to Refresh, it may be helpful to refer to our contributing 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 our Docs repo.

Made with 💙 for the LittleBigPlanet community