LogicCraft (Vanilla+ QoL & Immersion)

LogicCraft 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
    show_on_hold: true                  
    show_on_eat: true                  
    force_config_text: true
    debug_prefix: false
    tick_period: 10      
    hold_keep_ticks: 40  
    text: "&e{food}  &8|  {psat} {satbar}" 

---

⚙️ 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 ❤️