/minecrowdcontrol

Minecraft Crowd Control Plugin

Primary LanguageJavaOtherNOASSERTION

Minecraft Mod CI

Minecraft Crowd Control Mod

This is a modification for Minecraft (Java Edition) that can interact with Crowd Control

Features

  • Kill the player
  • Give / Take one Heart
  • Give / Take one Food
  • Set fire on player
  • Spawn Creeper / Enderman / Enderdragon / Blaze / Cave Spider / Spider / Witch / Bee / Horse / Skeleton Horse / Zombie Horse / Zombie / Cow / Chicken / Pig
  • Set Time Day / Night
  • Send player back to spawn point
  • Take all hearts and leave player with half
  • Fill all hearts
  • Invert Mouse (2 minutes)
  • Disable Jump (1 minute)
  • Make it hungry (take all food)
  • Food Blessing (fill food)
  • Make it rain (1 minute)
  • Gotta go fast (1 minute)
  • Drunk Mode (1 minute)
  • Destroy Selected Item
  • Drop Selected Item
  • Repair Selected Item
  • Explode Player
  • Drop a item to the player (Create Item)

Installing

For running this mod, you will need the oficial Minecraft Launcher and Minecraft Forge (1.15.2) installed.

Make sure you have Minecraft installed before doing anything.

1. Get Minecraft Forge

To get the Minecraft Forge, download the Forge Installer 1.15.2 and run it:

java -jar forge-1.15.2-31.0.16-installer.jar

Select Install Client and let it install on the default path:

Select Install Client

After that, a Minecraft Forge entry should appear in your Minecraft Launcher:

Forge in Launcher

Now you should be ready to install the MineCrowdControl.

2. Installing Minecrowd Control

  1. Go to Releases page and download the latest minecrowdcontrol jar file.
  2. Open Minecraft Launcher and start the Forge version you installed in the early step.
  3. Click in Mods Button
  4. Click in Open Mods Folder Button.
  5. Copy the jar file you downloaded to the folder that will open and restart the game.
  6. Go again to the Mods page and see if Minecraft CrowdControl is visible.

Minecraft Crowd Control

Changing Configuration

So far the 1.15.x version of forge has the GUI disabled for config (see MinecraftForge/MinecraftForge#6467) so if you want to disable the mod or the Crowd Control messages you should edit the file manually. The config file is stored at:

  • Windows: %appdata%\.minecraft\config\minecrowdcontrol-common.toml
  • Linux: ~/.minecraft/config/minecrowdcontrol-common.toml

The file config is pretty easy, just change to true to enable a feature or false to disable it:

[General]
	#Enables/Disables showing effect messages [false/true|default:true]
	showEffectMessages = true
	#Enables/Disables the whole Mod [false/true|default:true]
	enableMod = true

The showEffectMessages has a hot-reload function and can be changed without restarting the game.

The enableMod has a hot-reload function but you need to get back to the game main menu.

Testing

We use the Crowd Control SDK to test it which mimics the their server. Make sure you got it installed in your machine.

  1. Open Crowd Control EffectPack SDK
  2. Click in Load Pack Source
  3. Select minecrowdcontrol.cs (it is provided with releases and on the root of this repository)
  4. Select Minecraft in the list Minecraft and click button Select Pack
  5. Click in Connect button
  6. Open up Minecraft with the installed mod and it should connect automatically.

Effect List

Developing

TODO - Please refer to https://mcforge.readthedocs.io/en/latest/gettingstarted/


Source installation information for modders

This code follows the Minecraft Forge installation methodology. It will apply some small patches to the vanilla MCP source code, giving you and it access to some of the data and functions you need to build a successful mod.

Note also that the patches are built against "unrenamed" MCP source code (aka srgnames) - this means that you will not be able to read them directly against normal code.

Source pack installation information:

Standalone source installation

See the Forge Documentation online for more detailed instructions: http://mcforge.readthedocs.io/en/latest/gettingstarted/

Step 1: Open your command-line and browse to the folder where you extracted the zip file.

Step 2: You're left with a choice. If you prefer to use Eclipse:

  1. Run the following command: "gradlew genEclipseRuns" (./gradlew genEclipseRuns if you are on Mac/Linux)
  2. Open Eclipse, Import > Existing Gradle Project > Select Folder or run "gradlew eclipse" to generate the project. (Current Issue)
  3. Open Project > Run/Debug Settings > Edit runClient and runServer > Environment
  4. Edit MOD_CLASSES to show [modid]%%[Path]; 2 times rather then the generated 4.

If you prefer to use IntelliJ:

  1. Open IDEA, and import project.
  2. Select your build.gradle file and have it import.
  3. Run the following command: "gradlew genIntellijRuns" (./gradlew genIntellijRuns if you are on Mac/Linux)
  4. Refresh the Gradle Project in IDEA if required.

If at any point you are missing libraries in your IDE, or you've run into problems you can run "gradlew --refresh-dependencies" to refresh the local cache. "gradlew clean" to reset everything {this does not affect your code} and then start the processs again.

Should it still not work, Refer to #ForgeGradle on EsperNet for more information about the gradle environment. or the Forge Project Discord discord.gg/UvedJ9m

Forge source installation

MinecraftForge ships with this code and installs it as part of the forge installation process, no further action is required on your part.

LexManos' Install Video

https://www.youtube.com/watch?v=8VEdtQLuLO0&feature=youtu.be

For more details update more often refer to the Forge Forums: http://www.minecraftforge.net/forum/index.php/topic,14048.0.html