sovereign-engine 1.0.3

Procedural Game Engine powered by IntentShield and LogicShield (BSL 1.1)

# Sovereign Engine

The Zero-Trust Procedural Game Engine. Built securely on the IntentShield and LogicShield architectures.

Sovereign Engine allows game developers to seamlessly integrate LLMs (Large Language Models) into their games to generate procedural dialogue, dynamic quests, and complex NPC interactions while absolutely guaranteeing that the AI's output mathematically adheres to your game's rules.

Installation

pip install sovereign-engine

Features

• Deterministic Validation: The LogicShield backend forces the LLM to output perfect JSON that maps exactly to your defined game state parameters.
• Action Gatekeeper: A deeply integrated, ultra-fast IntentShield system intercepts the AI's intended actions, instantly rejecting anything that isn't functionally possible in your game.
• Engine Agnostic: Can be imported seamlessly into Unity (via Python backends), Unreal Engine, Godot, or standalone Python architectures.

Quick Start

from sovereign_engine.engine import ProceduralDialogueEngine

# The engine routes through OpenRouter automatically
engine = ProceduralDialogueEngine(api_key="sk-or-your-developer-key")

# Pass the player's current environment directly to the engine
scene = engine.generate_node(
    player_state={"level": 5, "inventory": ["Iron Sword", "Shield"]},
    recent_history=["You enter a dark cavern and hear a low growl."],
    player_action="I walk forward with my shield raised."
)

print(scene)

Customizing Rules (LogicShield) & Actions (IntentShield)

You can easily expand the engine to enforce your own custom mechanics mathematically, or allow new verbs for the AI to take (like CRAFT or STEAL).

from sovereign_engine.engine import ProceduralDialogueEngine
from sovereign_engine.logicshield.rules import Rule

# 1. Define custom JSON math validations
my_rules = [
    # Force the LLM to include a gold reward that is less than max_loot
    Rule.less_than("gold_dropped", "max_loot"),
    # Guarantee the AI never spawns a boss inside a tutorial zone
    Rule.custom(
        "no_bosses_in_tutorial", 
        lambda payload, state: not (payload.get("spawn_type") == "BOSS" and state.get("zone") == "Tutorial"),
        "You cannot spawn a BOSS in the Tutorial zone!"
    )
]

# 2. Inject them into the engine alongside allowed actions
engine = ProceduralDialogueEngine(
    api_key="your-key", 
    custom_actions=["STEAL", "CRAFT", "PERSUADE", "INTIMIDATE"], # Adds to base actions
    custom_rules=my_rules # Appends to base validation rules
)

License

This project is licensed under the Business Source License 1.1 (BSL 1.1). For production or commercial use, you must obtain a separate commercial license from SovereignShield.