HOSTimeline: A Historical Timeline and Event Management Add-On for Minecraft
Running a roleplay, civilization, or history-themed Minecraft server often demands more than just building and combat. You need a way to control the passage of time, trigger era changes, and script world-altering events that unfold as your server’s story progresses. That’s exactly what HOSTimeline delivers. Built specifically for Mohist 1.20.1, this add-on introduces a fully configurable timeline system that lets server owners automate date advancement, fire events on specific dates, and even create branching narratives using a powerful flag system.
What Is HOSTimeline?
HOSTimeline is a YAML-driven timeline and event engine that transforms your Minecraft server into a living, breathing historical simulation. Instead of manually announcing era changes or typing commands every time you want to advance the story, HOSTimeline handles it all automatically. You define a starting date, set the speed of time progression, and then map out events that occur when the timeline reaches certain dates. Each event can broadcast messages, execute console commands, or set flags that unlock future events. The result is a seamless, immersive progression that feels like a real historical timeline.
Key Features of HOSTimeline
- Automatic Time Advancement: The timeline moves forward on its own, configurable to match your server’s desired pace—whether that’s one day per real-world hour or a year per Minecraft week.
- Date-Based Event Triggering: Define events that fire when the timeline hits a specific date. Perfect for unlocking new technologies, spawning boss mobs, or announcing era transitions.
- Conditional Flag System: Set and check flags to create branching storylines. An event can require a flag to be true before it runs, allowing you to build complex, interdependent event chains.
- Multiple Action Types: Each event can broadcast messages to all players, run console commands (like giving items, changing game rules, or summoning structures), or set flags for future events.
- Manual Override Commands: Server admins can pause, resume, advance, or set the timeline date manually, giving you full control when you need to adapt the story on the fly.
- Event Logging: A built-in log command shows recent timeline events, so you can track what has happened and debug your configurations easily.
How to Install HOSTimeline on Your Mohist Server
Installing HOSTimeline is straightforward. Since it’s designed for Mohist 1.20.1, you’ll need a Mohist server running that specific version. Simply place the add-on JAR file into your server’s mods or plugins folder (depending on your Mohist setup) and restart the server. The add-on will generate its default configuration files automatically. If you prefer a one-click setup, the foxygame.net launcher includes HOSTimeline in its add-on catalog, allowing you to install it directly with automatic version matching and updates—so you never have to worry about compatibility or missing the latest features.
Configuration and Customization
HOSTimeline uses two main YAML files: config.yml and timeline_events.yml. The config.yml file controls the core timeline settings, such as the starting date, the speed of automatic time progression, and whether the timeline is paused by default. The timeline_events.yml file is where you define your custom events. Each event specifies a trigger date, one or more actions (broadcast, console command, or set flag), and optional conditions. The YAML structure is intuitive, making it easy to build a rich historical narrative without any programming knowledge.
Example Event Configuration
Here’s a simplified look at how an event might be structured:
events:
- date: 1500-06-15
actions:
- broadcast: "The Renaissance has begun! New technologies are now available."
- console: "give @a minecraft:book 1"
- set_flag: renaissance_started
- date: 1600-01-01
conditions:
- flag renaissance_started true
actions:
- broadcast: "The Age of Exploration is upon us!"
This system lets you chain events logically, ensuring that later milestones only occur if earlier ones have been completed.
Commands for Manual Control
While automation is the heart of HOSTimeline, you retain full command over the timeline with a set of intuitive in-game commands:
/timeline show– Displays the current timeline date./timeline set <date>– Jumps to a specific date instantly./timeline advance <amount>– Moves the timeline forward by a set number of days, months, or years./timeline pause– Halts automatic time progression./timeline resume– Restarts automatic advancement./timeline reload– Reloads all configuration files without restarting the server./timeline log– Shows recent event logs for troubleshooting.
Use Cases: From Kingdoms to Survival Scenarios
HOSTimeline shines in servers that revolve around historical eras, roleplay, or scripted progression. Imagine a civilization server where players advance through the Stone Age, Bronze Age, and Iron Age—each transition triggered by a timeline event that unlocks new crafting recipes or spawns new mobs. On a kingdom server, the timeline could dictate the rise and fall of dynasties, with events that change diplomatic relations or trigger wars. Even on a modded Mohist survival server, you can use HOSTimeline to introduce seasonal disasters, world-altering boss fights, or server-wide challenges that keep gameplay fresh and unpredictable.
Flag System for Branching Narratives
One of HOSTimeline’s most powerful features is its flag system. Flags are boolean variables that events can set or check. This allows you to create conditional storylines where the outcome of one event determines which future events will fire. For example, if players successfully defend a castle (setting a castle_saved flag), a celebration event might trigger later. If they fail, a different event—perhaps a siege aftermath—could run instead. This branching logic makes every server’s timeline unique and responsive to player actions.
Compatibility and Requirements
HOSTimeline is built exclusively for Mohist 1.20.1, a hybrid server platform that supports both Bukkit plugins and Forge mods. This makes it an ideal choice for modded servers that want to add timeline-driven events without sacrificing mod compatibility. The add-on integrates smoothly with Mohist’s architecture, and its public API allows other plugins to hook into the timeline system for even deeper customization. If you’re running a different server type, compatibility is not guaranteed, so be sure to verify your setup before downloading HOSTimeline.
Getting Started with HOSTimeline
To begin, download HOSTimeline from its official repository and place the JAR in your Mohist server’s mods folder. After a restart, the default configuration files will appear in the plugins/HOSTimeline directory. Edit config.yml to set your starting date and time scale, then populate timeline_events.yml with your custom events. Use the in-game commands to test and refine your timeline. For those who want a streamlined experience, the foxygame.net launcher provides a one-click install option that automatically handles version compatibility and keeps HOSTimeline up to date, so you can focus on crafting your server’s story rather than managing files.
Conclusion
HOSTimeline is a must-have for any Mohist 1.20.1 server that wants to deliver a dynamic, story-driven experience. Its flexible event system, automatic time progression, and conditional flag logic give server owners the tools to script complex historical narratives without writing a single line of code. Whether you’re building a roleplay kingdom, a civilization simulation, or a scenario-based survival world, HOSTimeline brings your timeline to life. Download it today and start shaping your server’s history.