Navi

<h2>Navi</h2> <p>A glowing fairy companion for Vintage Story, inspired by <em>Ocarina of Time</em>. She floats above your head, gives off real light, chimes when enemies are near, and remembers everything you teach her about herself — her name, her color, where she came from.</p> <h3>Carrying her</h3> <p>Two ways to keep her with you, crafted from <strong>clearquartz</strong> and either glass or gold:</p> <ul> <li><strong>Bottle</strong> (clearquartz on top, glass pane below) — <em>edited.</em> Capture a wild navi, then release her using the bottle.</li> <li><strong>Pendant</strong> (gold ingot on top, clearquartz below) — active carry. Hold right-click on the ground for 3.5 seconds to release her, hold right-click on her for 3.5 seconds to recall her into the pendant.</li> </ul> <h3>Interacting with her</h3> <p>Plain right-click chimes her bell. Hold sneak (Ctrl) + right-click on your Navi while the pendant is in hand to open the <strong>Edit Navi</strong> dialog:</p> <ul> <li>Type her a name — renders above her head like a player</li> </ul> <p>Only her owner can edit her. Everyone else just gets a chime.</p> <h3>Combat warning</h3> <p>When a hostile creature enters her 16-block line of sight, her glow turns red and she chimes once. She mutes for 10 seconds after warning so she doesn't drill your ear during long fights. Her glow returns to your chosen color when the threat passes.</p> <p>She also has flat damage reduction and slow self-regeneration so she survives close calls.</p> <h3>Wild encounters</h3> <p>Wild Navis spawn rarely in <strong>heavy, damp, low-elevation forests</strong> — about half as common as a vanilla fox. They drift within 100 blocks of where they spawned and have no owner, so any player can chime them.</p> <p>To tame a wild Navi, right-click her with a <strong>clearquartz</strong> in hand — she folds into a bottled creature item that you can equip.</p> <h3>Behavior notes</h3> <ul> <li>She trails behind your head when you move, orbits visibly when you sneak, and drops a block lower when you're sitting on a stool or the ground</li> <li>She emits real <code>lightHsv</code> light — everything she flies past lights up at the color you picked</li> <li>Multiple players can each own their own Navi without interfering; only one owned Navi per player at a time</li> </ul> <h3>Customizing her sound</h3> <p>The bundled <code>flutter.ogg</code> in <code>assets/navi/sounds/creature/navi/</code> is her single voice clip — played as her idle chime, her right-click chime, and her enemy-alert chime. Drop your own <code>.ogg</code> file at the same path to replace it. Pitch is set in the entity JSON — one place, applies everywhere.</p> <hr> <p><em>Author: Ranadriel. Written with the help of Claude Code (Anthropic).<br><br>Contribution: dimeymer (thank you!)<br><br></em></p> <div class="spoiler"> <div class="spoiler-toggle">Update Logs.</div> <div class="spoiler-text"> <p>v1.0.1 — bugfixes + wild behavior overhaul</p> <p>Fixes<br>• Bottle right-click no longer spawns a wild/unowned fairy — she now inherits<br>ownership from the player who released her.<br>• Pendant recall sticks: bottle auto-spawn is suppressed when the pendant<br>reports it's holding her, so she stays recalled instead of respawning.<br>• Wild Navi now respects block collision instead of phasing through terrain.</p> <p>Wild Navi behavior<br>• Real gravity (gravityFactor 0.3) — she falls when not actively flying,<br>hits walls instead of clipping through them.<br>• Active hover targets +2 above the topmost solid layer with 3-block look-ahead,<br>so she rises naturally over hills and trees instead of bumping into them.<br>• Wander speed reduced from formula-1 to a steady ~1 block/sec walk.</p> <p>Admin<br>• New /navispawn command (controlserver privilege) spawns a wild Navi at your<br>feet — useful for testing.</p> <p>Note for existing worlds<br>Wild-released fairies from v1.0.0 won't gain ownership retroactively. Re-bottle<br>them with clearquartz or wait for the 600s despawn timer.</p> <p>&nbsp;</p> <p>VERS, 1.0.2<br><br></p> <p>Fix: Name and color now persist across recall and respawn.</p> <p>Previously, when Navi was recalled into the pendant (or auto-respawned from the bottle), her color reset to gold and her name was lost. The customizations only lived on the live entity, so killing it destroyed them.</p> <p>The pendant and bottle now carry the saved color and name with them. Any carrier in your hotbar, character slots, backpack, or gear gets updated when you change her color/name through the edit dialog, and the next respawn restores from whichever carrier holds the saved state (pendant preferred over bottle).</p> <p>If you already have a Navi in the wild, open the edit dialog and re-pick her color and name once after updating — that writes the saved state to your carrier so future respawns will keep it.<br><br></p> <p>1.0.3</p> <p>- Releasing Navi no longer destroys her bottle — you keep an empty clearquartz<br>bottle in your inventory.<br>- New item: Empty Navi Bottle. Crafted indirectly: any time you release Navi<br>from a full creature-navi bottle, the empty one is left behind.<br>- Sneak + right-click on your Navi while holding an empty bottle to call her<br>back inside. Her name and glow are preserved on the resulting full bottle, so<br>re-releasing brings the same Navi back.<br>- Bottle swap also fires in Creative mode so the behavior is visible while<br>testing.<br>- Thanks to Codyman765 for the report.<br><br></p> <p>1.0.4 — Softer combat glow</p> <p>Alert light is now a warm sunset red-orange instead of an aggressive pure red.<br>The base warm glow reads through; the red sits on top as a tint. Less jarring<br>during cave combat, easier on the eyes over long sessions.</p> <p>Alert state now holds for 3 seconds after losing line-of-sight to a hostile,<br>so brief occlusions (drifter behind a rock, around a corner) no longer flicker<br>the glow off and back on.<br><br></p> <p>v1.0.5 — Russian localizati