Astral Core
Überblick
Astral Core ist die Magic-Systems-Bibliothek des Majestic Mod-Ökosystems für Minecraft NeoForge. Sie stellt die Frameworks bereit; sie enthält keinen konkreten Inhalt eigenen. Consumer-Mods und Datapacks bauen auf ihrer API auf.
Was es bietet
🌟 Essenz
Eine pro-Spieler Magieressource: Kapazität, Regeneration, stapelbare Modifikatoren (Altar-Nähe, Biom, Relikte, Forschung). Server-autoritativ, für HUD/UI an Clients synchronisiert.
🪄 Zaubern (Casting)
Ein Zauber/Fähigkeiten-Register (SpellType), Cast-Kontext, Targeting-Helper, pro-Spieler Cooldowns und client-seitige Partikel/Sound/Animation-Hooks.
🗿 Rituale
Eine Multiblock-Altar-Engine: Multiblock-Definition und Scan, RitualType, Phasen und konfigurierbares Fehlschlagsrisiko. Relikt-Schmieden ist ein High-Tier-Ritual, kein separater Rezept-Typ.
🔮 Forschung
Ein Wissensgraph aus Konstellations-Knoten mit pro-Spieler Unlock-Status und Triggern (“beim Item-Erhalt”, “beim Betreten einer Struktur”, …).
💎 Relikte
Ein Relikt-Verhaltensvertrag (passiv/aktiv), eine Bridge zur Regalia Slots API für Equip-Slots, und Set-Synergie-Unterstützung.
Anforderungen
| Anforderung | Version |
|---|---|
| Minecraft | 1.21.1 |
| NeoForge | 21.1.249 |
| Java | 21 |
Abhängigkeiten
| Abhängigkeit | Typ | Hinweise |
|---|---|---|
| Common Toolkit (MIT) | Geplant (noch nicht verdrahtet) | Config, Networking, Dynamic-Registry-Helper — wird ein externes JAR |
| Regalia Slots API (LGPL-3.0) | Erforderlich | Equip-Slots für Relikte — externes JAR |
Regalia Slots API ist eine externe Abhängigkeit — wird als separates JAR installiert, nie gebündelt (kein jar-in-jar). Common Toolkit ist geplant, aber noch keine Abhängigkeit.
Mod-Struktur
Astral Core ist als Bibliotheks-API mit dedizierten Subsystemen organisiert:
| Bereich | Zweck |
|---|---|
essence/ | Pro-Spieler Essenz-Daten-Attachment, API, Modifikatoren, Server→Client Sync |
cast/ | SpellType Registry, Spell Verhaltensvertrag, CastContext/CastResult, Targeting, Cooldowns, Client VFX Hooks |
ritual/ | Multiblock Def/Scan, RitualType Registry, Ritual/RitualContext/RitualResult/RitualPhase/RitualRisk, AltarBlockEntity Basis |
research/ | Pro-Spieler Wissensgraph: ResearchNode/ResearchGraph, Daten-Attachment, API, Trigger, Sync |
relic/ | Relic/RelicType Registries, RelicSlots (tag-driven via Regalia Slots API), RelicItem, RelicTickHandler, Set Synergie |
registry/ | Custom Registry Helpers |
event/ | Event Bus Utilities |
config/ | Konfiguration (NeoForge ModConfigSpec) |
net/ | Server→Client Sync Payloads (EssenceSyncPayload, etc.) |
Befehle
/astralcore status— Debug-Befehl zeigt registrierte Typen und Systemstatus
Kompatibilität
- Loader: NeoForge (erforderlich)
- Seite: Client & Server (beide erforderlich für Sync)
- API-Stabilität: Pre-Release (
0.0.0-beta.x) — die API kann sich vor 1.0.0 noch ändern - Keine bekannten harten Inkompatibilitäten — designed to work alongside other magic/library mods
Versionierung
| Status | Format | Aktuell |
|---|---|---|
| Beta / Entwicklung | 0.0.0-beta.X | 0.0.0-beta.1 |
| Stable Release | X.Y.Z (SemVer) | — |
JAR-Namensgebung: astral_core-1.21.1-neoforge-21.1.249-<version>.jar
Credits & Lizenz
Astral Core ist Teil des Majestic Ökosystems von Stalking Dragons.
Lizenz: MIT — siehe LICENSE.
Entwickelt und gewartet von Stalking Dragons.
Repository: https://gitlab.com/stalking-dragons/minecraft/astral-core
Overview
Astral Core is the magic-systems library of the Majestic mod ecosystem for Minecraft NeoForge. It provides the frameworks; it ships no concrete content of its own. Consumer mods and datapacks build on its API.
What it Provides
🌟 Essence
A per-player magic resource: capacity, regeneration, stacking modifiers (altar proximity, biome, relics, research). Server-authoritative, synced to clients for HUD/UI.
🪄 Casting
A spell/ability registry (SpellType), cast context, targeting helpers, per-player cooldowns, and client-side particle/sound/animation hooks.
🗿 Rituals
A multiblock altar engine: multiblock definition and scan, RitualType, phases, and configurable failure risk. Relic forging is a high-tier ritual, not a separate recipe type.
🔮 Research
A knowledge graph of constellation nodes with per-player unlock state and triggers (“on item obtained”, “on structure entered”, …).
💎 Relics
A relic behaviour contract (passive/active), a bridge to Regalia Slots API for equip slots, and set-synergy support.
Requirements
| Requirement | Version |
|---|---|
| Minecraft | 1.21.1 |
| NeoForge | 21.1.249 |
| Java | 21 |
Dependencies
| Dependency | Type | Notes |
|---|---|---|
| Common Toolkit (MIT) | Planned (not wired yet) | Config, networking, dynamic registry helpers — will be an external JAR |
| Regalia Slots API (LGPL-3.0) | Required | Equip slots for relics — external JAR |
Regalia Slots API is an external dependency — installed as a separate JAR, never bundled (no jar-in-jar). Common Toolkit is planned but is not a dependency yet.
Mod Structure
Astral Core is organized as a library API with dedicated subsystems:
| Area | Purpose |
|---|---|
essence/ | Per-player essence data attachment, API, modifiers, server→client sync |
cast/ | SpellType registry, Spell behaviour contract, CastContext/CastResult, targeting, cooldowns, client VFX hooks |
ritual/ | Multiblock definition/scan, RitualType registry, Ritual/RitualContext/RitualResult/RitualPhase/RitualRisk, AltarBlockEntity base |
research/ | Per-player knowledge graph: ResearchNode/ResearchGraph, data attachment, API, triggers, sync |
relic/ | Relic/RelicType registries, RelicSlots (tag-driven via Regalia Slots API), RelicItem, RelicTickHandler, set synergy |
registry/ | Custom registry helpers |
event/ | Event bus utilities |
config/ | Configuration (NeoForge ModConfigSpec) |
net/ | Server→client sync payloads (EssenceSyncPayload, etc.) |
Commands
/astralcore status— debug command showing registered types and system status
Compatibility
- Loader: NeoForge (required)
- Side: Both client and server (required on both for sync)
- API Stability: Pre-release (
0.0.0-beta.x) — the API may still change before 1.0.0 - No known hard incompatibilities — designed to work alongside other magic/library mods
Versioning
| State | Format | Current |
|---|---|---|
| Beta / Development | 0.0.0-beta.X | 0.0.0-beta.1 |
| Stable Release | X.Y.Z (SemVer) | — |
JAR naming: astral_core-1.21.1-neoforge-21.1.249-<version>.jar
Credits & License
Astral Core is part of the Majestic ecosystem by Stalking Dragons.
License: MIT — see LICENSE.
Developed and maintained by Stalking Dragons.
Repository: https://gitlab.com/stalking-dragons/minecraft/astral-core
Resumen
Astral Core es la librería de sistemas de magia del ecosistema Majestic para Minecraft NeoForge. Proporciona los frameworks; no incluye contenido concreto propio. Los mods y datapacks consumidores construyen sobre su API.
Qué Proporciona
🌟 Esencia
Un recurso mágico por jugador: capacidad, regeneración, modificadores acumulables (proximidad a altar, bioma, reliquias, investigación). Autoritativo en servidor, sincronizado a clientes para HUD/UI.
🪄 Lanzamiento (Casting)
Un registro de hechizos/habilidades (SpellType), contexto de lanzamiento, helpers de targeting, cooldowns por jugador, y hooks client-side de partículas/sonido/animación.
🗿 Rituales
Un motor de altar multibloque: definición y escaneo de multibloque, RitualType, fases, y riesgo de fallo configurable. La forja de reliquias es un ritual de alto nivel, no un tipo de receta separado.
🔮 Investigación
Un grafo de conocimiento de nodos de constelación con estado de desbloqueo por jugador y triggers (“al obtener item”, “al entrar en estructura”, …).
💎 Reliquias
Un contrato de comportamiento de reliquia (pasiva/activa), un puente a Regalia Slots API para slots de equipamiento, y soporte de sinergias de set.
Requisitos
| Requisito | Versión |
|---|---|
| Minecraft | 1.21.1 |
| NeoForge | 21.1.249 |
| Java | 21 |
Dependencias
| Dependencia | Tipo | Notas |
|---|---|---|
| Common Toolkit (MIT) | Planificada (sin cablear) | Config, networking, helpers de registro dinámico — será un JAR externo |
| Regalia Slots API (LGPL-3.0) | Requerida | Slots de equipamiento para reliquias — JAR externo |
Regalia Slots API es una dependencia externa — se instala como JAR separado, nunca empaquetada (no jar-in-jar). Common Toolkit está planificada pero todavía no es dependencia.
Estructura del Mod
Astral Core está organizada como una API de librería con subsistemas dedicados:
| Área | Propósito |
|---|---|
essence/ | Attachment de datos de esencia por jugador, API, modificadores, sync servidor→cliente |
cast/ | Registro SpellType, contrato de comportamiento Spell, CastContext/CastResult, targeting, cooldowns, hooks VFX cliente |
ritual/ | Definición/escaneo multibloque, registro RitualType, Ritual/RitualContext/RitualResult/RitualPhase/RitualRisk, base AltarBlockEntity |
research/ | Grafo de conocimiento por jugador: ResearchNode/ResearchGraph, attachment de datos, API, triggers, sync |
relic/ | Registros Relic/RelicType, RelicSlots (tag-driven vía Regalia Slots API), RelicItem, RelicTickHandler, sinergia de set |
registry/ | Helpers de registro personalizado |
event/ | Utilidades de event bus |
config/ | Configuración (NeoForge ModConfigSpec) |
net/ | Payloads de sync servidor→cliente (EssenceSyncPayload, etc.) |
Comandos
/astralcore status— comando de depuración que muestra tipos registrados y estado del sistema
Compatibilidad
- Cargador: NeoForge (requerido)
- Lado: Cliente y servidor (requerido en ambos para sincronización)
- Estabilidad API: Pre-release (
0.0.0-beta.x) — la API puede cambiar antes de 1.0.0 - Sin incompatibilidades duras conocidas — diseñado para funcionar junto a otros mods de magia/librerías
Versionado
| Estado | Formato | Actual |
|---|---|---|
| Beta / Desarrollo | 0.0.0-beta.X | 0.0.0-beta.1 |
| Release Estable | X.Y.Z (SemVer) | — |
Nombre del JAR: astral_core-1.21.1-neoforge-21.1.249-<version>.jar
Créditos y Licencia
Astral Core es parte del ecosistema Majestic de Stalking Dragons.
Licencia: MIT — ver LICENSE.
Desarrollado y mantenido por Stalking Dragons.
Repositorio: https://gitlab.com/stalking-dragons/minecraft/astral-core
Aperçu
Astral Core est la bibliothèque de systèmes de magie de l’écosystème Majestic pour Minecraft NeoForge. Elle fournit les frameworks ; elle ne contient aucun contenu concret propre. Les mods consommateurs et datapacks construisent sur son API.
Ce qu’il fournit
🌟 Essence
Une ressource magique par joueur : capacité, régénération, modificateurs empilables (proximité d’autel, biome, reliques, recherche). Autoritaire côté serveur, synchronisé vers les clients pour HUD/UI.
🪄 Lancer (Casting)
Un registre de sorts/habilités (SpellType), contexte de lancement, helpers de ciblage, cooldowns par joueur, et hooks client-side particules/son/animation.
🗿 Rituels
Un moteur d’autel multibloc : définition et scan de multibloc, RitualType, phases, et risque d’échec configurable. La forge de reliques est un rituel de haut niveau, pas un type de recette séparé.
🔮 Recherche
Un graphe de connaissances de nœuds de constellation avec état de déblocage par joueur et triggers (“à l’obtention d’item”, “à l’entrée dans une structure”, …).
💎 Reliques
Un contrat de comportement de relique (passive/active), un pont vers Regalia Slots API pour slots d’équipement, et support de synergie de set.
Prérequis
| Prérequis | Version |
|---|---|
| Minecraft | 1.21.1 |
| NeoForge | 21.1.249 |
| Java | 21 |
Dépendances
| Dépendance | Type | Notes |
|---|---|---|
| Common Toolkit (MIT) | Prévu (pas encore câblé) | Config, networking, helpers de registre dynamique — sera un JAR externe |
| Regalia Slots API (LGPL-3.0) | Requis | Slots d’équipement pour reliques — JAR externe |
Regalia Slots API est une dépendance externe — installée comme JAR séparé, jamais bundle (pas de jar-in-jar). Common Toolkit est prévu mais n’est pas encore une dépendance.
Structure du Mod
Astral Core est organisé comme une API de bibliothèque avec des sous-systèmes dédiés :
| Zone | But |
|---|---|
essence/ | Attachment de données d’essence par joueur, API, modificateurs, sync serveur→client |
cast/ | Registre SpellType, contrat de comportement Spell, CastContext/CastResult, ciblage, cooldowns, hooks VFX client |
ritual/ | Définition/scan multibloc, registre RitualType, Ritual/RitualContext/RitualResult/RitualPhase/RitualRisk, base AltarBlockEntity |
research/ | Graphe de connaissances par joueur : ResearchNode/ResearchGraph, attachment de données, API, triggers, sync |
relic/ | Registres Relic/RelicType, RelicSlots (tag-driven via Regalia Slots API), RelicItem, RelicTickHandler, synergie de set |
registry/ | Helpers de registre personnalisé |
event/ | Utilitaires d’event bus |
config/ | Configuration (NeoForge ModConfigSpec) |
net/ | Payloads de sync serveur→client (EssenceSyncPayload, etc.) |
Commandes
/astralcore status— commande debug affichant types enregistrés et statut système
Compatibilité
- Chargeur: NeoForge (requis)
- Côté: Client et Serveur (requis sur les deux pour le sync)
- Stabilité API: Pré-release (
0.0.0-beta.x) — l’API peut encore changer avant 1.0.0 - Aucune incompatibilité dure connue — conçu pour fonctionner aux côtés d’autres mods magie/bibliothèque
Versioning
| État | Format | Actuel |
|---|---|---|
| Beta / Développement | 0.0.0-beta.X | 0.0.0-beta.1 |
| Release Stable | X.Y.Z (SemVer) | — |
Nommage JAR : astral_core-1.21.1-neoforge-21.1.249-<version>.jar
Crédits & Licence
Astral Core fait partie de l’écosystème Majestic de Stalking Dragons.
Licence: MIT — voir LICENSE.
Développé et maintenu par Stalking Dragons.
Dépôt: https://gitlab.com/stalking-dragons/minecraft/astral-core
Visão Geral
Astral Core é a biblioteca de sistemas de magia do ecossistema Majestic para Minecraft NeoForge. Fornece os frameworks; não inclui conteúdo concreto próprio. Mods consumidores e datapacks constroem sobre sua API.
O que Fornece
🌟 Essência
Um recurso mágico por jogador: capacidade, regeneração, modificadores empilháveis (proximidade de altar, bioma, relíquias, pesquisa). Autoritativo no servidor, sincronizado para clientes para HUD/UI.
🪄 Lançamento (Casting)
Um registro de feitiços/habilidades (SpellType), contexto de lançamento, helpers de targeting, cooldowns por jogador, e hooks client-side de partículas/som/animação.
🗿 Rituais
Um motor de altar multiblocos: definição e scan de multiblocos, RitualType, fases, e risco de falha configurável. A forja de relíquias é um ritual de alto nível, não um tipo de receita separado.
🔮 Pesquisa
Um grafo de conhecimento de nós de constelação com estado de desbloqueio por jogador e triggers (“ao obter item”, “ao entrar em estrutura”, …).
💎 Relíquias
Um contrato de comportamento de relíquia (passiva/ativa), uma ponte para Regalia Slots API para slots de equipamento, e suporte a sinergia de set.
Requisitos
| Requisito | Versão |
|---|---|
| Minecraft | 1.21.1 |
| NeoForge | 21.1.249 |
| Java | 21 |
Dependências
| Dependência | Tipo | Notas |
|---|---|---|
| Common Toolkit (MIT) | Planejado (ainda não conectado) | Config, networking, helpers de registro dinâmico — será um JAR externo |
| Regalia Slots API (LGPL-3.0) | Obrigatório | Slots de equipamento para relíquias — JAR externo |
Regalia Slots API é uma dependência externa — instalada como JAR separado, nunca empacotada (sem jar-in-jar). Common Toolkit está planejado mas ainda não é dependência.
Estrutura do Mod
Astral Core é organizado como uma API de biblioteca com subsistemas dedicados:
| Área | Propósito |
|---|---|
essence/ | Attachment de dados de essência por jogador, API, modificadores, sync servidor→cliente |
cast/ | Registro SpellType, contrato de comportamento Spell, CastContext/CastResult, targeting, cooldowns, hooks VFX cliente |
ritual/ | Definição/scan multiblocos, registro RitualType, Ritual/RitualContext/RitualResult/RitualPhase/RitualRisk, base AltarBlockEntity |
research/ | Grafo de conhecimento por jogador: ResearchNode/ResearchGraph, attachment de dados, API, triggers, sync |
relic/ | Registros Relic/RelicType, RelicSlots (tag-driven via Regalia Slots API), RelicItem, RelicTickHandler, sinergia de set |
registry/ | Helpers de registro personalizado |
event/ | Utilitários de event bus |
config/ | Configuração (NeoForge ModConfigSpec) |
net/ | Payloads de sync servidor→cliente (EssenceSyncPayload, etc.) |
Comandos
/astralcore status— comando de debug mostrando tipos registrados e status do sistema
Compatibilidade
- Loader: NeoForge (obrigatório)
- Lado: Cliente e Servidor (obrigatório em ambos para sync)
- Estabilidade API: Pré-release (
0.0.0-beta.x) — a API ainda pode mudar antes de 1.0.0 - Nenhuma incompatibilidade dura conhecida — projetado para funcionar junto a outros mods de magia/biblioteca
Versionamento
| Estado | Formato | Atual |
|---|---|---|
| Beta / Desenvolvimento | 0.0.0-beta.X | 0.0.0-beta.1 |
| Release Estável | X.Y.Z (SemVer) | — |
Nome do JAR: astral_core-1.21.1-neoforge-21.1.249-<version>.jar
Créditos e Licença
Astral Core faz parte do ecossistema Majestic de Stalking Dragons.
Licença: MIT — ver LICENSE.
Desenvolvido e mantido por Stalking Dragons.
Repositório: https://gitlab.com/stalking-dragons/minecraft/astral-core