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 `
• 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

Copyright 2022, 2023 Silvio Mayolo

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/.