This repository contains the Manifold server.

You can find the client mod here.

Manifold is an open-source implementation of the bonk.io multiplayer servers made to allow complete freedom over the backend, making certain features possible, such as unlimited max players, unbanning, and ratelimit configuration.

Community and support

• SneezingCactus' Mods Discord server
• Bonk.io Modding Discord server

Tutorials

• Manifold Tutorial #1: Setting up a local server

Features

• Unlimited player limit
• Customizable server restrictions
• Chat logs
• Ability to unban people
• Persistent ban list (players banned in one session remain banned in every session after it, unless unbanned)
• Map and game settings persist as long as the server stays up (this is useful for map making because if your client crashes or you suffer an internet outage, as long as your server stays up, you can just join back and no progress will be lost)

---

Setting up a server

1. Make sure Node.js v20 or later is installed on your computer. You can check this by opening up a terminal and entering node --version. If it shows v20.0.0 or higher, you're good to go! If not, you may need to update Node.
2. Clone the repository, or download it as a ZIP by clicking the green "Code" button at the top of the page and then clicking the "Download ZIP" button.
   • If you downloaded the repository as a ZIP, make sure to extract it to a folder.
3. Go to the folder containing the repository, open a terminal, enter npm install and wait for the process to end.

You should be able to open the server now! Some things to get into consideration:

• To open the server, you can either open a terminal and enter npm run start, or you can run the start script file (start.bat on Windows, start.sh on Linux).
• If you host the server on your computer, you'll be able to access it through the URL http://localhost:{the port you're hosting the server on, 3000 by default}/.
• If you want people outside your network to be able to join your server, you'll have to host your server in the cloud using hosting services such as Render and Heroku. You can host it locally, but this is more difficult as you have to buy a domain, get SSL certificates and configure your DNS settings, so this is only recommended for advanced users.
• Server configuration is located in config.ts. You can modify it with any text editor.