Pendulum Chaos

--------------------------------------

What is Pendulum Chaos?

Pendulum Chaos is a Minecraft Bukkit plugin which allows you twitch viewers to vote for chaos events to happen on your server!

Currently the plugin has over 100 events and counting!

History

Pendulum started out as Chaos mod developed by me and my friend EnderCrypt under the name "DimaChaos", which has only been played by dima_wallhacks and PSP1G so far. As we continued the development, we decided to rename it to Pendulum Chaos.

Installation

DEPENDENCIES:
World Edit: https://modrinth.com/plugin/worldedit/versions
(World edit is internally used to spawn in structures needed in some events)

To install Pendulum Chaos has been built for PaperMC (but it should theoretically run on BUKKIT and Spigot as well).

Put the plugin jar file and the config.json file into the plugins folder.

Start the server to generate the config file.

In the config file, make sure to change the url under the resourcePack entry to be the IP of your server, this is required joining players to download the resource pack for custom item textures. (Unless you know what you're doing, leave the port to be 8080).

OBS OVERLAY:
If you're playing this plugin on twitch, you'll to setup a browser source in OBS (so that your chat can see what they can vote for.) Add your servers IP with the port 8080 to it. (Example: localhost:8080) I recommend the following OBS Browser source settings: 600x600, Control sounds via OBS. Make sure OBS plays the sounds for you and your stream using the advanced sound settings. (I recommend putting the volume at -15db, as the sounds may get loud.)

Edit the config.json file and add the twitch channels the plugin should count the votes from.
Example:
"twitchChannels": ["Fehleno", "Forsen"]
(This will make the plugin read the votes from the twitch channel Fehleno and Forsen. If the config entry is empty, you'll be playing without the twitch integration, and a random event will happen whenever the bar is full.)

FAQ

Q: What is Karma and Bias in the config file?
A: Experimental system that tries to give a balance of good and bad events. For now, it's recommended to not change it's values as it's not fully operational yet.

Q: Can I change the likelihood of a specific event?
A: Yes, find the event you want to appear more or less often in the config.json file. Change the "chance" field to either 1 or 0. 1 means it has the same odds as every other event, where 0 means it cannot appear at all. You can set values like 0.5 for example.

Q: Can I disable specific events?
A: Yes, find the event you want to disable in the config.json file and change the "enable" field to false.

Contact

If you find any bugs, you can report them at the projects gitlab page: https://gitlab.com/Fehleno/pendulum-chaos/-/work_items