GlymeraObelisk v3.0

GlymeraObelisk - Defensive Lightning Obelisk

A 17-block gold-brick monument that automatically fires glowing energy bolts at hostile or aggressive creatures within a configurable 3D cube radius. Owner-protected, craftable, with custom sound and particle effects.

Most actual version only working for Hytale stable 5 !

What is GlymeraObelisk?

GlymeraObelisk gives you a static defensive structure you can plant in your base, your farm, your trade outpost, anywhere you want to keep hostile mobs out. Place a single item, and a full 17-block gold-brick obelisk rises from the ground. From the moment it stands, it will quietly scan the area around it and pick off any creature that is hostile to players, or any creature that can become hostile to players (predators, mythic beasts) — while leaving peaceful livestock and prey alone.

It is built from native Hytale blocks, hooks into the native NPC attitude system to decide who is a valid target, and uses a custom particle and sound pair so you can clearly tell when one of your obelisks is engaging.

How It Works

Placement
Craft or pick up an Obelisk item. Right-click any block to place. The item triggers placement of a 17-block structure at that position:

• 7 stacked Rock_Gold_Brick_Ornate blocks form the central column
• 4 Rock_Gold_Brick_Roof blocks form a sloped base around the bottom
• 4 Rock_Gold_Brick_Beam blocks form a cross at the top
• 1 Rock_Gold_Brick_Pillar_Base + 1 Rock_Gold_Brick_Beam crown the tip

The block layout is captured 1:1 from a hand-built template, so the orientations are guaranteed to be correct.

Targeting
Every second, each obelisk scans a 3D cube around its anchor (default: 16-block half-edge, i.e. 33x33x33 blocks) and looks for valid targets.

A creature is a valid target if:

• Its default attitude toward players is HOSTILE (always-aggressive: zombies, skeletons, goblins, troops...), OR
• Its default attitude toward players is NEUTRAL AND its AttitudeGroup is not "Prey" or "Livestock" (predators that can be provoked: bears, wolves, mythic beasts...)

Peaceful animals like armadillos, rabbits, sheep, chickens, cows, pigs etc. are never targeted. The closest valid target is selected per tick.

Firing
The obelisk fires from its tip (top beam):
1. A laser-flash sound and a chain of golden energy spheres travel from the tip toward the target
2. A delayed impact (based on distance and projectile speed, default 50 blocks/s) plays an explosion sound and applies damage at the target
3. Damage is dealt as PHYSICAL and is environmental-sourced ("Obelisk")

Default damage: 50 HP per shot. Default fire interval: 1 second.

Sound
Two custom sound events are bundled:

• SFX_Obelisk_Shot — the laser-flash at the obelisk tip
• SFX_Obelisk_Impact — the explosion at the target

Both have 3D positional attenuation (full volume from 0-1 blocks, fading to silence at 20 blocks).

Particles
A custom particle system ObeliskBolt is bundled. It uses a round Ball6.png texture, square-scaled so the particle reads as a small glowing sphere from any angle. Coloured gold (255, 215, 0) per spawn via the packet's color modifier.

Crafting

Craft at the Workbench in the Survival category:

• 3x Greater Essence of Life (Ingredient_Life_Essence_Concentrated)
• 5x Gold Bar (Ingredient_Bar_Gold)
• 5-second craft time, yields 1 Obelisk

The recipe can be disabled via config; OPs can still spawn Obelisks via /obelisk spawn.

Commands

/obelisk spawn — Spawn an obelisk at your current position (OP only)
/obelisk remove — Remove the nearest obelisk in this world (OP only)
/obelisk list — Show how many obelisks you own and the world total (anyone)
/obelisk capture <halfWidth> <height> — (Build tool) capture a volume of blocks as the placement template (OP only)
/obelisk captureat <x> <y> <z> <halfWidth> <height> — (Build tool) capture from explicit world coordinates (OP only)

The capture commands are how the template was built originally. Most servers will never need them — the bundled template is correct out of the box.

Block Protection

• Only the obelisk's owner (the player who placed it) or an OP can damage or break it
• Damage from other players is silently cancelled
• Breaking by owner/OP removes the entire 17-block structure and returns 1 Obelisk item to the breaker's hotbar inventory (with a /give fallback if the hotbar is full)
• Each block of the obelisk is marked as "deco" via BlockPhysics.markDeco so the cross arms and decorative pieces don't fall when a neighbour changes

Configuration

File at plugins/GlymeraObelisk/config.json (created on first start):

• guardRadius (default: 16) — 3D Chebyshev (cube) half-edge in blocks. Total covered = (2*r+1)^3
• attackNeutral (default: true) — If true, also target NEUTRAL creatures (predators that can be provoked). Peaceful prey is always excluded regardless
• fireTickMs (default: 1000) — How often each obelisk scans + shoots, in milliseconds
• damage (default: 50.0) — HP damage per shot
• projectileSpeed (default: 50.0) — Visual projectile speed in blocks/second. Controls impact delay only
• recipesEnabled (default: true) — Whether the Workbench recipe is allowed. Set to false to gate access to /obelisk spawn only

Persistence

• plugins/GlymeraObelisk/obelisks.json — placed obelisks (world, anchor position, rotation quarter, owner UUID). Atomically written via tmp + fsync + atomic rename, survives crashes
• plugins/GlymeraObelisk/template.json — the captured block template (overrides the bundled default if present)
• plugins/GlymeraObelisk/config.json — settings

Features

• 17-block structure from a single item — placement triggers a multi-block layout with correct rotations
• 3D cube targeting with configurable radius (no infinite vertical range)
• Attitude-aware filtering — hostile + provoke-able predators, never peaceful prey
• Custom particle + sound system bundled in the JAR
• Owner protection — only owner or OP can damage/break
• Item-on-break — breaking returns the item to the breaker's hotbar
• Physics-stable — BlockPhysics.markDeco prevents the cross-arms from falling
• Recipe toggle via config
• Persistent + atomic save of placed obelisks

Good to Know

• The obelisk is built from native Hytale gold-brick blocks — no custom models needed
• Peaceful prey and livestock are never targeted, even with attackNeutral enabled
• The projectile is purely visual — damage is applied server-side on a timed delay matching the visual travel time
• Multiple obelisks can overlap in coverage area without conflicts

Sound Credits

• Shot sound based on "flash-laser-gun" by the freesound community
• Impact sound based on "pixel-explosion" by Lumora Studios

Both samples have been trimmed and re-encoded to OGG.

Installation

1. Place GlymeraObelisk.jar in your server's mods/ folder
2. Start (or restart) the server
3. Done! Everything is embedded in the JAR — no external asset folders needed.

Made with care by Glymera for the Hytale community