LogicCraft

LogicCraft (Vanilla+ QoL & Immersion)

LogicCraft is a modular “vanilla+” plugin that enhances immersion and QoL without changing the base gameplay: Wet Boots, 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 HEAD or HEAD * Respects torch particles (if enabled) * Water attenuation + extinguish in water

🧱 `block_physics`

Improved physics for sand/gravel:

* chain_collapse: prevents unfair deaths (breaks and drops if the column is small) * chain_collapse: 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:

* quick_deposit: 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:

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

Example config:

```yml

============================================================

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):

```yml 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 ❤️