00-Argonath-Wiki

Frequently Asked Questions

General Questions

What is Argonath Systems?

Argonath Systems is a modular framework ecosystem for creating quest-driven experiences in Hytale. It provides reusable components for quests, NPCs, UI, configuration, and more.

Is it only for Hytale?

The core platform is game-agnostic. While we provide a Hytale adapter, you could create adapters for other games or platforms.

Do I need to use all modules?

No! The modular design lets you pick only what you need. Use bundles for convenience or individual modules for control.

Is it free?

Yes, Argonath Systems is open source under the MIT License.

Getting Started

What do I need to get started?

Which bundle should I use?

See Bundles vs Modules for details.

Where are the examples?

Check the examples/ directory in the main repository or browse the examples section in this wiki.

How do I report bugs?

Open an issue in the main repository.

Development Questions

Can I create custom quest objectives?

Yes! See Custom Objectives.

How do I persist quest data?

Use framework-storage. See Storage Guide.

Can I create custom UI components?

Absolutely! See UI Development.

How do I handle quest branching?

Use the condition system. See Conditions.

Technical Questions

What’s the difference between frameworks and bundles?

How are dependencies managed?

Maven handles all dependencies. Just add the bundle or modules you need to your pom.xml.

Can I use this with other mods?

Yes! Argonath is designed to work alongside other mods. See External Mods Integration.

What’s the performance impact?

Minimal. The framework is optimized for efficiency. See Performance Guide.

Troubleshooting

Build fails with “module not found”

Ensure you’ve added the Argonath repository to your pom.xml:

<repositories>
    <repository>
        <id>argonath-systems</id>
        <url>https://maven.pkg.github.com/yourusername/Argonath-Systems</url>
    </repository>
</repositories>

Quest doesn’t appear in game

Check:

  1. Quest is registered: questRegistry.register(quest)
  2. Prerequisites are met
  3. Quest giver is placed in game
  4. Debug logging is enabled

NPCs don’t respond to interaction

Verify:

  1. NPC is registered: npcRegistry.register(npc)
  2. Interaction handler is bound
  3. Interaction distance is configured
  4. Hytale adapter is initialized

UI doesn’t display

Check:

  1. UI manager is initialized
  2. UI component is created and shown
  3. UI coordinates are visible on screen
  4. No conflicting UI from other mods

Migration Questions

Can I migrate from legacy systems?

Yes! See Migration Guide.

Will my old quests work?

Migration tools are provided. See Upgrade Guide.

What about breaking changes?

All breaking changes are documented in Breaking Changes.

Contributing

How can I contribute?

See Contributing Guide for details on:

Do I need permission to contribute?

No! Fork the repo and submit a PR. We welcome all contributions.

What if my PR is rejected?

We’ll provide feedback. You can revise and resubmit.

Community

Is there a Discord?

Coming soon! Check the README for updates.

Where can I ask questions?

Can I share my mods?

Please do! We’d love to see what you create. Share in Discussions!

Don’t see your question? Ask in Discussions or open an Issue.

This site is open source. Improve this page.