CreakingPerks

Made by apoapiodev

Overview

CreakingPerks is a comprehensive gameplay enhancement plugin for Minecraft servers running Paper/Folia 1.21.8+. The plugin introduces 10 fully modular systems that enhance mob difficulty, add unique mechanics, and introduce new craftable weapons. All modules are independently toggleable and highly configurable.

Folia Compatibility

This plugin is fully compatible with Folia's regionized threading system, using appropriate schedulers for all operations to ensure thread-safe execution across different regions.

Core Features

Module Management

• Command: /creakinghelp [page]
• Aliases: /chelp, /cph
• Interactive chat GUI with clickable buttons to enable/disable modules
• Paginated display showing all available modules
• Real-time configuration saving
• Module status indicators (ENABLED/DISABLED)

Module Toggle

• Command: /creakingmodule toggle <module>
• Aliases: /cmodule, /cpm
• Instantly toggle any module on/off
• Changes persist across server restarts

Modules

1. HarderCreakings

Makes Creaking mobs significantly more challenging with enhanced abilities.

Features:

• Speed X effect (configurable level, default: 10)
• Increased damage: 20 HP (10 hearts) per hit
• Blindness effect applied on hit
• Darkness aura: Applies darkness to players within 10 blocks when moving
• Auto-applies speed buff to all existing Creakings on enable

Configuration:

speed-level: 10
damage: 20.0
blindness-duration: 5
darkness-radius: 10.0

2. HarderBreeze

Projectile rain, increased fire rate, radiation zones, and special drops.

Features:

• Projectile Rain: When a Breeze damages a player, spawns falling Wind Charges from the sky
• Rain lasts 3 seconds (60 ticks) with 5 projectiles per wave
• Increased Fire Rate: Breeze attacks every 0.5 seconds instead of normal cooldown
• Radiation Zones: Wind Charges have 5% chance to create radiation zones on impact
  • Zones deal 1 heart/second damage
  • Apply radiation effects (item loss, fire, knockback)
  • Last 6 seconds
  • Protection: Chainmail Helmet prevents radiation
• Special Drops on Death:
  • 1-100 Breeze Rods (random amount)
  • 1-3 units of a random rare material (Diamond, Emerald, Netherite Scrap, Ancient Debris, Totem of Undying, Nether Star, Elytra, Trident, etc.)
  • Special death effects with particles and sounds
• Visual Explosions: Wind Charges create particle explosions with knockback
• Explosions don't break blocks but push players and entities

Configuration:

projectile-rain-amount: 5
projectile-rain-radius: 3.0
projectile-rain-duration: 60
explosion-knockback: 1.5
attack-cooldown: 10

3. HarderBogged

Bleeding effect that empowers other hostile mobs.

Features:

• Green Bleeding: Players hit by Bogged bleed green particles for 5 seconds
• Blood Particles: Green particles fall to the ground and persist for 5 seconds
• Mob Empowerment: When mobs step on blood particles:
  • Instant full health regeneration
  • 25% size increase (visual via metadata)
  • 50% damage increase
  • Speed and Resistance effects
  • Buff lasts 10 seconds
• Bogged themselves are immune to the buff

Configuration:

bleeding-duration: 100
blood-particle-duration: 100
particle-spawn-interval: 5
mob-buff-duration: 200
mob-size-multiplier: 1.25
mob-damage-multiplier: 1.5

4. HarderArmadillo

Protective spheres that block projectiles and push away intruders.

Features:

• Dynamic Sphere: Radius increases as Armadillo loses health
  • Base radius: 10 blocks
  • +5 blocks per 20% health lost
  • Maximum radius: 35 blocks at low health
• Projectile Blocking: All projectiles entering the sphere are destroyed
• Player Pushing: Players trying to enter from outside are pushed away
  • Players inside when sphere is created can move freely
  • Configurable push force (default: 1.5)
  • Electric spark particles and sound when pushed
• Visual Effects: Blue particle sphere with horizontal rings
• Sphere lasts 5 seconds after taking damage
• Barrier particles and sounds when blocking projectiles

Configuration:

base-sphere-radius: 10.0
radius-per-health-loss: 5.0
sphere-duration: 100
particle-density: 20
push-force: 1.5

5. HappyGhastBomber

Aerial bomber system with radiation projectiles.

Features:

• Activation: /activarbombardero (aliases: /bomber, /activatebomber)
• Deactivation: /desactivarbombardero (aliases: /stopbomber, /deactivatebomber)
• Requirements: Must be riding a Happy Ghast (minecraft:happy_ghast) and have TNT in inventory
• Ammunition System: TNT items are consumed as ammo (not actual TNT blocks)
  • Consumes 1-5 TNT randomly per second
  • Stops automatically if not enough TNT available
  • Drops 5 Wind Charge projectiles per use
• Projectile Behavior:
  • Spawns 5 blocks below rider to avoid self-damage
  • Wind Charges fall in random spread pattern
  • 100% chance to create radiation zones on impact
• Radiation Zones: Ground areas that deal continuous damage:
  • 1 heart/second damage to players inside
  • Knockback and fire effects
  • Item dropping every 3 seconds for 6 seconds
  • Poison and Nausea effects
  • Green and black radiation particles on ground
  • Lasts 6 seconds
  • Protection: Chainmail Helmet prevents radiation
• No Block Damage: Compatible with servers that have TNT disabled

Configuration:

slow-drop-interval: 20
fast-drop-interval: 20
min-tnt-threshold: 10
explosion-radius: 5.0
explosion-knockback: 2.0
fire-duration: 100
radiation-duration: 120
radiation-item-drop-interval: 60
particle-density: 50

6. HarderStray

Freeze damage effect that reduces max health or deals direct damage.

Features:

• Freeze Effect: Lasts 5 seconds when hit by Stray
• Two Damage Modes:
  • Max Health Reduction (default): -0.5 hearts every second
  • Direct Damage: 8 hearts every second
• Visual Effects:
  • Slowness II and Mining Fatigue I
  • Snowflake and ice particles
  • Freeze sounds
• Max health automatically restores when effect ends

Configuration:

freeze-duration: 100
use-max-health-reduction: true
max-health-reduction: 0.5
direct-damage: 16.0
freeze-damage-interval: 20

7. IllusionerSpawn

Natural spawning of Illusioner mobs with special rewards.

Features:

• Rare Spawn: 0.1% chance to replace naturally spawning hostile mobs
• Periodic Spawns: Attempts spawn near players every 30 seconds
• Smart Spawning:
  • Only in Overworld
  • Requires solid ground and low light level
  • Spawns 30-60 blocks from players
• Special Drop: Enchanted Golden Apple on death
• Visual Effects: Portal particles, enchantment effects, custom name
• Named "Illusioner" in purple bold text

Configuration:

spawn-chance: 0.001
drop-enchanted-golden-apple: true
spawn-check-interval: 600

8. LavaDamage

Lava melts armor rapidly, with special Netherite mechanics.

Features:

• Regular Armor: Melts in ~6 seconds in lava
  • 50 durability damage per second
  • Destroyed when durability reaches 0
• Netherite Armor (Oven Effect):
  • Armor repairs instead of taking damage (+10 durability/second)
  • Player takes heavy damage (2 hearts/second)
  • Melts non-Netherite items from inventory every 2 seconds
  • Message: "The netherite armor is cooking you alive!"
• Auto-Detection: Automatically detects when entering/exiting lava
• Visual Effects: Different particles for regular vs Netherite armor

Configuration:

armor-damage-interval: 20
armor-damage-amount: 50
netherite-health-damage: 4
netherite-item-melt-interval: 40
netherite-repair-amount: 10

9. DryWeapon

Craftable weapon that shoots leaf projectiles with special effects.

Features:

• Crafting: 8 Copper Blocks + 1 Leaf Litter (center)
  • 5% chance to fail crafting
  • Random fire rate assigned (1-3 shots/second)
• Ammunition: Leaf Litter
• Ammo Consumption: Random 1-10 leaves per shot
• Durability: 150 uses (displayed in lore, updates in real-time)
• Damage System:
  • 0-5 blocks: 0.5 hearts
  • 5-10 blocks: 1 heart
  • Maximum range: 10 blocks
  • Works on all living entities (players, mobs, animals)

Special Effects (each 20% chance, only for players):

1. Tornado (at 5+ leaf hits in 60 seconds):

   • Lifts player upward with double force
   • 2 leaf hits = 2 blocks lift (doubled)
   • Maximum 100 blocks effective lift
   • Tornado particle effects

2. Burning Leaves:

   • Sets player on fire when moving
   • Lasts 3 seconds
   • Fire particles

3. Vegetal Splinter:

   • Slowness + Mining Fatigue
   • Stacks with more hits
   • Lasts 5 seconds

4. Durability Damage:

   • Damages random equipped items
   • 5 durability per hit
   • Can break items completely

Configuration:

weapon-durability: 150
long-range-damage: 2.0
short-range-damage: 1.0
max-range: 10
min-ammo-cost: 1
max-ammo-cost: 10
craft-fail-chance: 0.05
min-fire-rate: 1
max-fire-rate: 3
tornado-chance: 0.2
fire-effect-chance: 0.2
splinter-effect-chance: 0.2
durability-damage-chance: 0.2

10. FreezingSnowball

Snowballs apply freeze effects to any living entity.

Features:

• Freeze Effect: Applied when snowball hits any player or mob
• Duration: 3 seconds (60 ticks)
• Effects Applied:
  • Slowness II
  • Mining Fatigue I
• Visual Effects:
  • Snowflake particles
  • Light blue ice particles
  • Glass breaking sound
  • Freeze hurt sound
• Works on all living entities (players, mobs, animals)

Configuration:

freeze-duration: 60
slowness-level: 2
mining-fatigue-level: 1
particle-density: 15

Commands

Command	Aliases	Description
/creakinghelp [page]	/chelp, /cph	Opens interactive module management GUI
/creakingmodule toggle <module>	/cmodule, /cpm	Toggles a specific module
/activarbombardero	/bomber, /activatebomber	Activates Ghast bomber mode
/desactivarbombardero	/stopbomber, /deactivatebomber	Deactivates bomber mode

Permissions

Permission	Description	Default
creakingperks.admin	Full access to all commands	OP
creakingperks.bomber	Allows using bomber mode	true

Configuration

All modules are highly configurable through config.yml. Each module has its own section with detailed options for:

• Damage values
• Effect durations
• Spawn rates
• Visual effects
• Cooldowns
• And more

Changes to the config require a server restart or module reload to take effect.

Technical Details

• API Version: 1.21.3
• Java Version: 21
• Server Software: Paper/Folia
• Thread-Safe: Full Folia compatibility with region schedulers
• Performance: Optimized with efficient task scheduling and cleanup
• Persistence: Module states saved to config.yml

Installation

1. Download the plugin JAR file
2. Place in your server's plugins folder
3. Start/restart your server
4. Configure modules in plugins/CreakingPerks/config.yml
5. Use /creakinghelp to manage modules in-game

Support

For issues, suggestions, or questions, contact apoapiodev.

Credits

Developer: apoapiodev

All modules are designed to enhance vanilla Minecraft gameplay while maintaining balance and server performance.