Blood on the Clocktower Minecraft mods (Fabric 1.21.1)

This Gradle multi-project contains three modules:

• botc-helpers-server — server-side BOTC player-count helper and named script library.
• botc-helpers-client — client-side script import screen and resource-pack integration.
• botc-helpers-common — networking payloads shared by the server and client.

Targets Minecraft 1.21.1, Fabric Loader 0.16+, Fabric API, and Java 21.

Importing and selecting script images

Install the server mod on the server and the client mod on every player client that should display the custom script texture. The client mod never reads the system clipboard itself; the operator explicitly pastes into the in-game field.

1. Copy the complete data:image/png;base64,... value from the BOTC script website, or copy the raw base64 string.
2. As an operator, run /botcscript save trouble_brewing (replace the example name with a name of your choice).
3. Paste the data URL/base64 into the screen's input field and click Upload and save. Use Ctrl+V yourself; no automatic clipboard access occurs.
4. The server validates the image and stores it in config/botc-scripts.json. Saved names use letters, digits, _ and -, up to 32 characters. Uploading an existing name replaces that entry.
5. Activate a saved script with /botc script select trouble_brewing.

Available operator commands (permission level 2):

• /botcscript save <name> — open the explicit paste/import screen.
• /botc script list — list saved scripts and the active selection.
• /botc script select <name> — activate and broadcast a saved script.
• /botc script status — show the active script.
• /botc script clear — clear the active texture while retaining saved scripts.
• /botc script delete <name> — delete a saved script.

The library and active selection persist across restarts in config/botc-scripts.json. The server accepts images up to 8 MiB decoded, with dimensions no larger than 2048×2048. The encoded import is sent in chunks, so it does not need to fit in a Minecraft command. The custom texture overrides the vanilla map background/empty-map texture; it does not create filled map data. Players without the client mod can still join, but see the vanilla texture.

Existing player-count commands

All /botc commands require operator permission level 2:

• /botc add <amount> — add extra players (for example, Travellers).
• /botc remove <amount> — remove extra players.
• /botc set <amount> — set extra players directly.
• /botc count — show connected players, the excluded Storyteller, extra players, and resulting game-player count.

The role distribution remains visible in the action bar and updates once per second. Extra-player count resets when the server restarts.

Build

Requires JDK 21. From the project root:

./gradlew build

JARs are produced under each module's build/libs/ directory. Install the server jar on the server and the client jar on each compatible client.