Crowd Control Setup Guides

Automatic Setup

We suggest this setup if you want to play Minecraft: Java Edition alone on a new world. For anything else, check out our Advanced Setup!

Our support for Minecraft is based on different server frameworks. These allow for more flexibility while keeping your launcher setup clean. Find more info below.

1. In the Crowd Control app, select Minecraft from the Game Library or Live tab

2. From the CC app, press “Configure Minecraft”

3. For playing alone, select the “Local” server type.

4. Select Framework (we suggest Fabric)

5. From the CC app, press “Click to install”.

6. From the CC app, press “Launch Server”.

7. Now that your server is running, open Minecraft and select Multiplayer.

8. Click Add Server, and use Server Address 127.0.0.1. Then, join your server.

9. When your load in, you will be prompted to “Click here”. Follow the on screen instructions.

Advanced Setup / Modded Setup / Multiplayer Setup

If you want to play on an existing singleplayer world, a dedicated multiplayer server, a pre-1.21.2 version, or on a modpack, then please read the Advanced Setup Wizard!

Minecraft Frameworks

While we may have supported other frameworks in the past, only these are kept up to date! See the Advanced Setup for more information on custom modded setups.

Fabric

This version is generally updated to new releases the fastest. It also supports the most features, though you will need to install the mod on your client to utilize them.

Minecraft Version: Supports 1.21.5 trough 26.3, old versions available for 1.19.2+

Config: config\crowdcontrol.conf

https://fabricmc.net/

NeoForge

This version is very similar to the Fabric version, though more experimental. To use all its features, you will need to install the mod on your client.

Minecraft Version: Supports 1.21.5 through 26.3, old versions available for 1.19.2+

Config: config\crowdcontrol.conf

https://neoforged.net/

Paper

This version features the best performance and stability but is updated to new releases slower than Fabric.

Minecraft Version: Supports 1.21.2 through 26.3, old versions available for 1.19.4+

Config: plugins\CrowdControl\config.yml

https://papermc.io/

Tips

These tips should work for any of the above supported server frameworks! (unless noted otherwise)

Effect Statuses

This game pack uses the Effect Status system to dynamically disable or hide effects from your viewers. In the app, this appears as “Effect has been hidden from viewers by the game” or “This effect is unavailable in the current game state. Check the game guide for more information.” Effect Statuses are an intentional feature that help ensure that your viewers can only purchase effects that work with your setup. Listed below are some reasons that an effect may be unavailable and how you may be able to make them available.

• You aren’t using “global” mode - Effects that apply to all players on a server are disabled or nerfed when you haven’t enabled the “global” config setting. Alternatively, if you want to enable these effects without necessarily sharing effects directly with other players, you can add your username to the “hosts” config setting.

- Examples: Set Time to Day, Clear Weather, Hard Mode, Freeze Time, Teleport Entities to Players (nerfed)

• You don’t have the client mod installed - The mod can optionally be installed on your Minecraft client to enable some extra effects.

- Examples: Screen Effects (legacy only), Language Shuffle (requires an extra Fabric-only mod)

- Note that some outdated versions of the client mod do not support client effects. These versions are unsupported.

• The effect state is already active - It can’t be used because the effect is a “toggle effect” and the toggle is already on.

- Examples: Peaceful/Easy/Normal/Hard Mode, Keep Inventory On/Off

• You don’t have enough players - Effects can require that you have 2+ online in-game players. They either must be linked to the same account or you must have “global” mode enabled.

- Examples: Swap Players, Unite Players

Reset World

If you’ve played before and wish to start a new world, then you can delete the “world” folders on your server, which will generate a new seed when it next loads.

1. Make sure your Minecraft Server is not running.

2. From the Crowd Control desktop app, head to Config > Game Paths. Find Minecraft, and click the folder icon.

3. From Windows Explorer, open the folder for the framework you are playing.

4. Delete all “world” folders, including “world_nether” and “world_the_end”

5. Relaunch from the Crowd Control desktop app to regenerate a new world!

Global Effects

If you’re looking for effects to happen to all players, you will need to edit the config file corresponding to your Minecraft framework. Please refer back to the “Minecraft Frameworks” section of the guide to find where the file is for your framework. Once you’ve found the file, open it in a text editor and look for the following line:

global: false

If you find a line that looks like that, you can delete it. If you don’t find that line, that’s okay.

Now, you can add a new line to the file:

global: true

Save the file, then in the server run /crowdcontrol reloadconfig or restart the server and now any effects sent to a player will be repeated on others.

Server Commands / Cheats

When using commands on the server, you will want to exclude any / from your commands. You will also want to run these commands from the black server window that opens when you “Launch Server”. You can find some useful basic commands here. The example pictured below shows how you can add a player as an operator, allowing them to run commands in-game.

Downgrading

When a new Minecraft update releases, it can take some time for us to bring support to the new version as we wait for some third-parties to update their tools. If you get an “Incompatible version” or “Outdated server! I’m still on X.Y.Z” error message, then follow these steps to downgrade your client:

1. In the Minecraft Launcher, ensure you have selected Minecraft: Java Edition on the left, then click Installations

2. In the new tab, select New Installation

3. Open the Version dropdown and select the version that was named on the “Outdated server” error screen, then click Install

4. If the game does not launch automatically, then you should be able to find your new profile near the bottom of your Installations list and click Play.From this tab, you can also find and switch back to the Latest release near the top of the list once our mod updates.

Bedrock Edition

While not officially supported, some users have seen success joining the modded server from Bedrock Edition clients after installing Geyser.

Hardcore Mode

Although you can enable hardcore mode, it is not necessarily recommended as you will have to restart your session upon every death, which can be quite often if your chat is particularly chaotic. We instead recommend using the Paper framework with our Fahare plugin which generates a new world upon death without closing the server. You can install the plugin by downloading it into the Paper/plugins folder, similarly to how you might reset your world using the steps above.

“Failed to bind to port”

If you’re unable to connect to the automatically setup server in-game and see this error message in the console logs, it means another app on your PC is using Minecraft’s port. This could just mean that the server was accidentally opened twice, if so closing them all out and reopening should help. If you’re using VTube Studio, make sure to launch the server before you open VTS.

“Reconnecting to socket in 1 second(s)”

The socket server requires a new connection every few hours, causing this message. This is intentional, not a bug.

If you see this messaged spammed with increasingly large timeouts then an issue has occurred to prevent you from connecting to the socket server. This may be due to an expired login. You can use /account unlink to log out and /account link to log back in. If you continue to experience issues, please share your server log file in a support ticket on our Discord server.

Custom Effects

Custom Effects are currently available under a very early beta on supported versions of the mod. Please refer to the Advanced Setup Guide to tell if your version is supported (if you see a colorful box reading “The selected Minecraft version is no longer receiving mod updates on this modloader” at the top of any relevant guide article, it is not supported). Even on supported versions we cannot guarantee that all effects will work and cannot offer refunds for coins spent on them; see more information about this at the bottom of the section.

Setting up Custom Effects requires knowledge of editing schema-compliant files. They can be setup in your config file, whose location we described earlier under Modding Frameworks. Inside the file, you will find an example block of effects underneath the custom-effects that have been “commented out”, this means we used a comment character # to disable that part of the config. The config file for each framework is different, so please refer to the instructions within the file for how to “uncomment” the examples and enable the feature. If you do not see these example blocks, you likely instead see a block of text noting that the config file has been truncated and that a full version can be found online: please follow this link, download the full config file, and replace the config file with it.

Custom Effects are defined by:

• name (using Minecraft’s text component)

• price in the Interact Link / Extension (integer number, must be at least 1)

• an optional description

• an optional file name for an image filename corresponding to a pre-existing effect ID

• optional list of categorys to sort the effect into

• actions

actions is a list of at least 1 action to run when the effect is requested. We of course support running arbitrary chat commands, but we also offer several alternatives which we recommend using where possible as they are generally safer to run and less likely to cause your viewers to spend coins on nothing.

• summon-entity: summons an entity given its ID in type, a location relative to the player, and any extra NBT data to apply. (NBT data may have issues on Paper, in particular when trying to add passengers. Paper’s API is limited here and there is not much we can do to fix it on our end.) Compatible with limits config setting.

• give-item: gives an item to the player, provided a full item stack argument and an optional quantity. Compatible with limits config setting.

• run-command: runs a chat command as the player.

If you experience issues with run-command not providing coin refunds to players, you can always refund them yourself from the Crowd Control app while the session is running. Customer support is not able to provide refunds for these effects or any custom effects, but our developers would love to hear on the mod’s issues page what use case you are having that isn’t covered by our premium built-in actions.

Credits

Thanks to Lexi for being our resident Minecraft expert and continually maintaining and improving this mod! You can find the full project, including tips and additional setup details here.