LogicCraft

!(https://res.cloudinary.com/dhgdy73up/image/upload/v1774164949/ChatGPT_Image_22_mar_2026_01_35_19_a.m._e7yod4.png)

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

```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..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:

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 f