LogicCraftt

LogicCrafft is a modular “vanilla+” plugin that enhances immersion and QoL without changing the base gameplay: dynamic lighting without shaders, smarter physics for sand/gravel (if three blocks fall on you, you don’t suffocate), XP orb fusion to reduce lag, biome titles, oxygen bottles (an empty glass bottle can give you air underwater), cave quakes, ambient drips, quick campfire cooking (throw the item and it cooks), door synchronization (double doors now open with one click), hoe replanting (right/left click replants if you have seeds), and Wet Boots (wet footsteps + dripping).

✅ Everything is configurable per module and per world.
⚡ Focused on being lightweight: tasks with tick_period, cooldowns, radii, and limits.

✨ Features (by module)
biome_title
Shows a Title when changing biome, with:

• Cooldown to avoid spam
• Configurable fade in/out
• Colors per biome
• Disabled worlds list
  
  

dynamic_light
Dynamic lighting when carrying items like torch/lantern/etc.

• Configurable light level
• Place light at FEET or HEAD
• Respects torch particles (if enabled)
• Water attenuation + extinguish in water

block_physics
Improved physics for sand/gravel:

• smart_suffocation: prevents unfair deaths (breaks and drops if the column is small)
• compaction: compacts large stacks (gravel→cobble, sand→sandstone)
• chain_collapse: chain collapse with delay, max height, optional same material only

⭐ xp_fusion
Fuses nearby XP orbs:

• Reduces lag from orb “spam”
• Glow threshold
• Optional particles on fusion

⚡ fast_flow
Inventory QoL:

• siphon: quickly “pulls” items using shulker/ender chest item
• quick_deposit: right click to deposit quickly (optional: only items already in container)

oxygen_bottles
Oxygen bottles:

• Converts a glass bottle into “air bubbles”
• Cooldown, fill delay, requires eyes underwater, consumes bottle

cave_quake
Underground tremors:

• Gating by minimum height and cave size
• 2 phases: warning → impact
• Falling dripstone + optional gravel/sand fall
• Configurable camera shake
• Configurable audio

water_drip
Cave ambience: dripping when underground

• Upward check, radius, max_y, cooldown, volume

campfire_cook
Quick cooking near campfire: drop the item and it cooks

• Radius + cooking ticks

door_sync
Synchronizes double doors

• Optional: trapdoors and fence gates

harvest_replant
Automatically replants when harvesting (QoL survival style)

wet_boots
When leaving water, the player becomes “wet”:

• Sound and dripping while walking
• Configurable duration
• Step cooldown
• Optional particles
• Can ignore if flying or not on ground

Perfect, here’s the missing module translated and integrated into the English documentation style so it matches the rest:

food_hint
Now you can see your saturation and hunger hints, similar to AppleSkin but server-side:

• show_on_hold: Displays hints when holding a food item
• show_on_eat: Displays hints when eating
• tick_period: Update frequency
• hold_keep_ticks: Persistence duration while holding
• text: Customizable template for display (food, saturation, bar, etc.)

Example config:

# ============================================================
food_hint:
enabled: true # Hunger/Sat hints
show_on_hold: true # Show on item hold
show_on_eat: true # Show when eating
tick_period: 10 # Update period
hold_keep_ticks: 40 # Persistence
text: "&e+{food} &6+{sat}✨ {bar} &8| &6SAT:{psat} {satbar}" # Template

⚙️ Configuration
Everything is controlled from config.yml:

• modules.<module>.enabled: enable/disable modules
• disabled_worlds: list of worlds where the module won’t run
• tick_period, cooldown_ticks, radius_blocks, etc: performance and frequency

Example (summary):

modules:
dynamic_light:
enabled: true
tick_period: 3
light_level: 15
place_at: "FEET"
water_extinguish: true
items: [TORCH, LANTERN, GLOWSTONE]

cave_quake:
enabled: true
tick_period: 60
cooldown_ticks: 1200
chance_per_check: 0.02

Performance (tips)
If you want it more “lightweight”:

• Increase tick_period (fewer checks)
• Increase cooldown_ticks (fewer events)
• Lower chance_per_check
• Lower radii (radius_blocks, sample_radius)
• Disable particles (warning_particles, particle_on_merge, drip_particles)

✅ Compatibility

• Designed for Paper (recommended).
• Should work on compatible forks (Purpur, etc).

Note: if you use pure Spigot, some modern APIs may vary depending on build. Paper is the most stable for these kinds of features.

Installation

1. Download the .jar
2. Place it in /plugins
3. Restart the server
4. Adjust config.yml
5. (Optional) /logiccrafft reload if you added a reload command (if applicable)

Permissions / Commands
/logiccrafft reload

• Permission: logiccrafft.admin

❓ FAQ
Why do some modules “not always feel” active?
Because they use chance_per_check + cooldown_ticks. It’s not constant—intentionally immersive, not spammy.

Can I disable things per world?
Yes: disabled_worlds: [ world_nether, world_the_end ] in each module.

Can the quake last longer?
Yes: adjust in screen_shake:

• Longer duration: increase shakes and/or interval_ticks
• More intensity: increase strength (carefully)

Changelog (template)
v1.0

• Added: Wet Boots module
• Improved: Dynamic Light placement/behavior
• Tweaks: Cave Quake tuning & configs
• Fixes: general stability

Credits

• Inspired by “vanilla+” and QoL
• Thanks to the community for feedback/testing ❤️