A Turtle's Troll

This is a Minecraft plugin for Paper which introduces several "troll" mechanics to the survival multiplayer experience. See Features.org for the full feature list.

This is a companion project to EvanSkiStudios' Raccoon-Mischief. Neither directly depends on the other, but they are designed with each other in mind.

NOTE: This plugin is only compatible with Paper. It uses Paper-specific features not available in Spigot.

Building

gradle build

Acknowledgments

A Turtle's Troll is written and maintained by Mercerenies. It is released under the MIT License.

A Turtle's Troll also depends on the following libraries.

The Kotlin runtime (Included and automatically bundled in the produced JAR File)
org.json (Included under the JSON License)

A Turtle's Troll also provides integrations with a few other plugins. None of these are required, but some features may be unavailable if these dependencies are not present.

ProtocolLib is required for the rainwater feature. If ProtocolLib is not present, this feature will be disabled.
Raccoon-Mischief is recommended for interoperation with several features. Nothing strictly requires this plugin to be present, but many things either make more sense or integrate better if both this as Raccoon-Mischief are present.
DiscordSRV, if present, will mirror any messages from A Turtle's Troll to Discord.

Changelog

Version 1.25

Random events that apply to players do not fire if there are no players online (currently this is all random events, though in the future there may be events that make sense with no players)

Version 1.24.2

ProtocolLib is now an optional dependency. If not present, rainwater will be disabled and a warning will be printed, but all other features will still function.
Discord integration: If DiscordSRV is present, then messages from this plugin will be shown on Discord.

Version 1.24.1

Patch release: Fix Cataclysm to be less destructive.

Version 1.24

Made several changes to the temperature system.
- Leather armor no longer causes you to overheat in hot weather.
- Cold weather requires that you're wearing a chestplate and leggings. The other slots don't matter. Leather armor will keep you warm in cold weather.
- Helmets that ARE armor count toward overheating in hot weather. That is, an iron, gold, netherite, or chain helmet will cause you to overheat in deserts. Carved pumpkins and other "fun" hats do not.
- Umbrella hats now protect against the heat.
- There is now a /turtle temperature command that tells you what your current temperature is.
New random event: Kamek swaps items in your inventory.
New random event: Anvils rain down on everyone continuously for a bit.
New random event: Sand blocks rain down on everyone continuously for a bit.
New random event: A giant blob of sand falls on everyone at random.
New random event: Two players are entered into a prisoner's dilemma.
New random event: Blocks near players are replaced by magma and Nether blocks.
Witches can now spawn allays as well as parrots.
The player who appeases the gods gets awarded one experience point for every Twitch streamer currently streaming Minecraft.
Eggs can now hatch into killer rabbits, not just ordinary ones.
You can now safely trade with villagers if you have a pumpkin on your head.
Block drop events now change their likelihood based on the player's luck stat.
Added several more trivia questions.
Added teleport sound effects.
Added titles to random events.
Added titles and sound effects for gods' demand events.
Added more parrot names.
Fixed a bug with trivia rewards.

Version 1.23

Obsidian walls generate uniformly in a grid shape around the map.
Y=69 never generates anything at world generation time.
Umbrella hats will protect you from the rain.
Mimic chests can now spawn as trapped or double chests.
Mimic chests now show a variety of different possible displays.
The "Old Age" effect resets your level to zero when you exceed the age limit.
Pufferfish and trivia events are now fired by a central event manager, rather than on their own timers.
Birch trees attack players.
Players might get teleported to each other's positions at random.
Bees never spawn on trees if you break the wood with a wooden axe.
Removed a particularly obnoxious cookie effect.
Improved logic of chestshuffle effect.
The parrot launch message now includes the parrot's name.
Fixed bug with trivia if a player logs out during a question.
Improved some debugging capabilities.
Debug commands are now in the /turtle dbg namespace.

Version 1.22

When a player dies, they might be banished to a superflat world instead of the regular one.
There are now random 1x1 holes in every world.
Bowser events sometimes fire now in place of the usual gods' demands.
If you have Invisibility or Night Vision, then the Warden will not appear in the dark.
When a trivia question is asked, a sound effect plays for all online players.
Nylium does not explode if you're wearing a pumpkin when you look at it.
Added Herobrine.

Version 1.21

Arrows duplicate and bounce off of blocks when they hit them.
Flint and steel + an ender pearl crafts a Blaze Eye, which can be used in the Nether to find a fortress.
Whenever a player takes damage, redstone wire is placed at their feet.
Temperature mechanics no longer consider the "helmet" slot when computing player temperature.
Raccoon-style cake slices are now detected as being cake.
When you mine a block, there's a small chance the game will treat it as though you had Silk Touch.
When a player dies, nearby entities get Regeneration.
Bees have a chance of spawning named "Apache".
Fixed some bugs with the lava/water fluid mechanics.
Added several new trivia questions.

Version 1.20

Starting with version 1.20, A Turtle's Troll is now licensed under the GNU GPL v3 or later.
A Turtle's Troll has been updated to run in Minecraft 1.20.1.
Minecraft Trivia! Every ten minutes, the game asks a trivia question.
Lots of stats are configurable now, and A Turtle's Troll now has difficulty tiers. The "default" gameplay up to this point is now called "normal" mode.
Players deplete oxygen in the rain.
Looking at nylium transforms it into primed TNT.
Jumps may fail if you're overencumbered.
Tools enchanted with Silk Touch negate most block-breaking effects this plugin provides.
When you pull a fish hook in, you're launched in that direction.
Eating the last bite of a cake causes it to explode.
Pufferfish explode on death.
Looking at a cactus causes the player to be kicked.
Piglins accept diamonds and give enchanted armor in exchange
After getting out of bed, you get some random status effects.
Any bucket without a custom name will randomly change its contents every eight seconds.
If a fish is drying out, it will create water to survive.
The gods' death conditions are now tiered; harder conditions only appear if you've satisfied them a lot recently.
When shearing a sheep, the color of wool dropped is randomized.
Endermen can only be damaged by a player's bare fist.
Breeding animals sometimes spawns a Vindicator named "Johnny".
Killing a pillager summons slimes.
Lava running on water creates obsidian, while water running on lava created cobblestone.
When a moss block is broken, small chance of small slime to spawn.
The Warden summon condition has been increased to seven seconds.
Added a warning message if the player has been in darkness for more than 3.5 seconds.
Grass spreads slower than in vanilla.
The gods' death condition feature has been renamed from bedtime to demand.
Fixed a bug with the "Lightning" death condition.
Fixed a bug with raytracing for torches.
All messages originating from the plugin have a common prefix now.
A Turtle's Troll now depends on Paper, not just Spigot.
Switched to Gradle build system, massively improving build times.

Version 1.19

A Turtle's Troll has been updated to run in Minecraft 1.19.2.
A Warden appears near any player who spends more than five seconds in total darkness.
Allays automatically bond to the nearest player and have an infinite supply of flowers.
Killing (or exploding) non-charged creepers summons allays.
Villagers, zombie villagers, and wandering traders drop leather.
Added mangroves to leaf/log/plank effects.

Version 1.18

Poké Balls can be crafted and thrown to capture mobs
Iron golems are always angry at the nearest player, have Speed 1 and Regeneration 1, and ride spiders (does not apply to player-crafted golems)
Mobs drop redstone dust, picking up redstone dust deals a small amount of damage
When slimes die, they split into larger slimes
When a player eats bread, there's a 10% chance that a small slime spawns near them
When you attempt to open a chest, a different, nearby chest might accidentally be opened instead
When a player opens an ender chest, they see the ender chest inventory of whoever died most recently
If a boat hits the ground hard enough, it explodes
If a full Minecraft day goes by with no one dying, every player receives a small reward taken from a random pool
mobGriefing is off by default; if a player dies for any reason, it turns on for ten minutes
When a player dies, all other players gain a level
Lava buckets can be crafted into chainmail armor
Snowballs have reverse knockback
Added more death conditions to appease the gods
Chicken explosions respect mobGriefing now

Version 1.17

Zombies and skeletons sometimes spawn with special hats which drop when they're killed.
Parrots get tiny gravestones when they die
All rabbits are killer rabbits now
Feeding cookies to parrots causes them to duplicate now
Pumpkin helmets no longer count as armor for temperature purposes
Custom hats (per Raccoon Mischief) no longer provide the protection or downsides of ordinary carved pumpkin hats
Red sand and sandstone now apply the sandattack effect as well
Red sand will sometimes fall during sandattack

Version 1.16

Eating cookies grants one of several random effects
If you start mining an ore and then stop, it gets mad and runs away
Armor stands generated to be weeping angels can have random-colored armor
Description of features can be gotten with /turtle describe <feature>
Added a feature to spawn a Weeping Angel for debugging purposes
Rain now protects the player from hot weather as well
Fixed a bug with wandering trader item generation

Version 1.15.1

A parrot on your shoulder will launch you into the air
Parrots will become attached to the nearest player automatically
Witches will sometimes attack by throwing parrots at you
Fixed a bug with zombietrade
Updated the temperature scaling for easier use as a scoreboard
Fixed temperature scoreboard to take into consideration held items
Fixed temperature scoreboard to take into consideration the Nether and End

Version 1.15

All pigs and striders spawn with saddles and have adjusted speed when riding
Fixed spillage producing water in the Nether
Fixed death scoreboards persisting across worlds

Version 1.14

A Turtle's Troll is now open source!
Holding a hot item (like a lava bucket) protects from cold biomes, and holding a cold item (like a block of ice) protects from hot biomes
A scoreboard showing player death counts is automatically created and displayed on the right side of the screen
shieldsurf now works on lava damage too
A (hidden) scoreboard keeps track of all player temperatures
Silverfish burn in daylight
classiclava has been revamped to be much more controlled
lavalaunch also grants Haste now
classiclava works in the Nether now
ghastlava has been nerfed and re-enabled

Version 1.13

The block two cubes below the player is constantly being turned to lava
When a player opens an inventory other than their own, the current item they're holding is dropped
When a bucket item is dropped for any reason, its contents will spill on the ground
The bedtime event now shows a boss bar to indicate the current bedtime condition
If a player has four distinct potion effects, they begin to levitate in the air

Version 1.12

A Turtle's Troll is now built for Minecraft 1.18.2 against the latest Spigot API
Bamboo spreads like crazy now
Phantoms can randomly turn into witches now; witches do not take fall damage
Wither skeletons have a 50% chance of spawning with bows rather than swords now
Gravestones appear in ten different unique shapes now at random (thanks, HatCrafter)
Gravestones do not replace any blocks other than air now
Melons and pumpkins switch a lot of their functionality
When a zombie drowns, it turns into a Giant, not a Drowned
Moss blocks are included in the netherrack effect now
Cats turn into bats when killed, and bats turn into cats when killed (only when killed by the player)
When amethyst blocks are broken, they have a small chance of dropping golden apples
The contagious moss effect now extends down to the new bedrock layer of Y=-64
Pointed dripstone arrow recipe is now upside-down (thanks, EvanSki)

Version 1.11

gravestone will not replace chests now.
Players must wear armor in cold biomes and wear nothing in hot biomes, or they will take climate damage (does not apply in the nether)
Dirt and sticks can be crafted into each other now
Chickens are immune to Pufferfish damage
Pointed dripstone arrows now have tags and a custom name marking them as different (thanks, EvanSki)
Fixed Weeping Angel arm pose again (thanks, EvanSki)
Fixed several of the death conditions for bedtime

Version 1.10

Tenth version hype! I'd like to thank my friends for dealing with my shenanigans through ten versions of this thing. Love you guys <3
Each day at dawn, the gods will demand to see someone die in a specific way; if nobody dies that way on that day, then no one will be allowed to sleep that night
Wandering traders can trade basically any item in the game
Llamas are now constantly angry, and their spit has increased knockback
Netherite hoes can one-shot any non-boss mob in the game
Pointing a shield at the ground can negate fall damage
Every player gets a free cookie at dawn and at dusk
When logs/planks are broken, a random log/plank type is dropped
Ghasts instantly burn in daylight
Some zombies spawn with custom names
Zombies move slightly faster
Weeping Angel arm pose is fixed now
Armor stands can be crafted into jungle wood slabs now
Armor stands with custom name "raccoon" are not Weeping Angels now
Lowered the rate of dripstone stalactites spawning
Pointed dripstone can be used in place of flint to craft arrows
A player who reaches Level 100 dies of old age
Cleaned up the command API quite a bit
Added /turtle bedtime command to see what the gods' current request is

Version 1.9

Whenever a player dies, a gravestone appears at the site of death
When an axolotl dies, the nearest player also dies (within 32 blocks)
Killing a charged creeper always drops a diamond
Drowned zombies spawn alongside fish
Angels, mimics, and cakes all have local spawn limits now
Fixed a bug with the Weeping Angel pursuit code

Version 1.8

Pufferfish rain on all players at noon
Taking fall damage causes the Slowness and Confusion effects
Pillagers spawn with crossbows named "AK47" which have Quick Charge V
Lava spreads further in the overworld and the End
forestfire effect has been extended to apply to ice as well as leaves
Ice blocks turn to bedrock when broken
The obsidian crop overgrowth effect has been changed to turn crops into logs instead

Version 1.7

Chipped and damaged anvils can be smelted, like regular anvils
Breaking glass gives the victim seven years of the Unluck potion effect
Several crops turn to obsidian if not harvested within ten minutes of maturing
The Ender Dragon drops TNT at regular intervals and is fully immune to explosion damage
Ender Crystals spawn with Blaze spawners beneath them
Tridents always explode on contact now
Dirt placed in the End turns into a Shulker now
Dolphin's Grace now prevents the electric water effect
Fixed an issue with passive mobs failing to convert to chickens in Minecraft 1.17

Version 1.6

Pointed dripstone stalactites generate in the wild and will fall if you walk below them

Version 1.5

A Turtle's Troll is now built for Minecraft 1.17 against the latest Spigot API
Cakes spawn in the wild and, when eaten, grant one of several random effects
Explosive arrows can be crafted with arrows and gunpowder
Wither skeletons spawn with full diamond armor now
Moss generates in all overworld chunks and spreads rapidly
Restored torch/light behavior to drop when looked at
Added axolotls, goats, and glow squids to the list of egg hatch mob possibilities
Undead mobs now often hatch from eggs with helmets
Villagers who transform into zombie villagers via trading keep the correct profession now
Copper ore and deepslate ores now count as ores for drop and levitation purposes
1.17 slab and stair blocks behave like other slab and stair blocks for the slowness effect
Deepslate can produce a silverfish effect now, like other stone blocks
Azalea leaves are leaves, for the purposes of fire and bedrock effects

Version 1.4

Beds don't drop when mined anymore
Anvils can be smelted into iron nuggets
Almost any mob can spawn from an egg
Diamonds can spawn from an egg
Skeletons will fire eggs in addition to arrows
Several mobs drop eggs when killed
Bats and rabbits never transform into chickens anymore
Anvils have a minimum height above you they can spawn
Drastically increased the pet phantom respawn cooldown (to 10 minutes)
Torches and other lights now turn into redstone torches rather than dropping when you look at them
The slow slab effect and wither rose effect are both disabled if you're wearing boots, similar to grass poison now
All of the effects that involve mob spawning are corrected to only affect natural mob spawning, not eggs or spawners

Version 1.3

Mimics will spawn, which look like chests but kill you instantly if opened
Touching lava causes players to launch a short distance into the air
Torches and lanterns have a cooldown after being placed during which they will not break
The grass poison/slowness effect will not apply if you're wearing boots; instead, your boots lose one durability when you touch tall grass
Wearing a pumpkin on your head allows you to go in water without getting electrocuted (but provides mining fatigue and slowness)
Weeping Angels will now spawn rarely in the wild
Weeping Angels now provide a custom death message
Fixed several of the glitchier aspects of the Weeping Angels effect
Pet phantoms have a respawn cooldown now

Version 1.2

Buttons and levers have durability now, similar to doors
Pressure plates have a slight chance of catching fire when you step on them
Decreased the rate of bats turning into chickens as a lag-prevention measure
Slabs and stairs slow the player down
Torches and lanterns break if you look at them
Everybody gets a pet phantom now

Version 1.1

All features can be toggled on an individual basis using the /turtle command now
Stripped wood will now correctly trigger the bee effect
Crimson and warped stems can now trigger the bee effect
Nether brick works like netherrack and other "common nether materials" now
Rabbits are replaced by chickens now
All flowers (and berry bushes) give the wither effect now
A higher percentage of chickens will spawn with baby zombie riders now
End stones have the same effect as snow (Haste)
Doors break after some number of uses
Weeping Angels effect on armor stands
Several blocks turn into bedrock when mined
When the player stands on some blocks, sand will fall from above
Standing on ore gives Levitation

Version 1.0

Initial release

Licensing

A Turtle's Troll is free software licensed under the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

A Turtle's Troll is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with A Turtle's Troll. If not, see https://www.gnu.org/licenses/.

Mercerenies / a-turtles-troll