Security updates are provided for the latest minor release line:
| Version | Status |
|---|---|
| 1.3.x | Maintained |
| < 1.3.0 | Unsupported |
If you identify a security vulnerability in umbra (for example anything that
could abuse the reflection handles it uses against Minecraft/Forge internals,
the config parsing, or a crafted input that could crash or un-protect a
server), please report it responsibly.
- Open a private advisory report through GitHub Security Advisories at https://github.com/koreaeatsrice/umbra/security/advisories/new
- Or email
koreaeatsrice@gmail.comwith the subject line[SECURITY] umbra Vulnerability Report.
- Clear description of the vulnerability and potential impact.
- Steps to reproduce or proof-of-concept (a small test pack is ideal).
- Mod version, GTNH pack version, and the relevant
logs/fml-server-latest.logexcerpt. - Any suggested remediations or mitigations.
Reports are handled on a best-effort basis as time permits. There are no formal response timelines or resolution SLAs. Confirmed security fixes will be tagged and released via standard repository releases.
Umbra is a server-side spawn-rule addon that changes light-based spawning to match modern Minecraft. Its security-relevant boundaries are:
- Fixed reflection handles: the mod resolves a small set of Minecraft internals (light lookups, dimension ids, the day/night clock) once at start-up and caches them. It loads no user-supplied class names.
- No network, no code loading: the mod opens no sockets, downloads
nothing, and executes no code from data. Client machines need nothing
installed (
acceptableRemoteVersions = "*"). - Fail-safe by design: if any handle fails to resolve, the mod logs a
DISARMED/init FAILEDline and falls back to vanilla behaviour instead of crashing or half-applying rules. - Server operator's control: the whole rule set is config-gated
(
config/umbra.cfg), including per-dimension caps and the exempt-entity list.