One Block Engine

One Block Engine adds a magic block that changes as you break it. Each phase has its own blocks, mobs, chests and rewards, and you move to the next phase after breaking a set number of blocks. The mod contains the engine only. The content (phases, blocks, mobs) comes from a mode, written in JSON in a datapack or edited in game.

Made by Eltyy, from the Eltyy studio.

For players

• Press O (rebindable) to open the player view: a timeline of the phases (finished, current, upcoming), a progress bar, and for each phase the chance of every block and every mob.
• Chests and barrels in a phase are filled from loot tables. Milestones inside a phase can show a message and run commands (a boss, a wave, a gift).
• When a phase ends, its rewards are given at the block.
• Commands: /oneblock info, /oneblock view, /oneblock home, /oneblock modes. Players without the mod can still play: they get the commands and text messages.
• Fallen blocks (sand, gravel) get a barrier underneath so they do not fall into the void.

For modpack creators

• Modes in JSON. A mode is a file in data/<namespace>/oneblock/modes/ of a datapack. A phase has an id, a name, an icon, a colour, the number of blocks to break, weighted blocks, mobs (chance per block, maximum in a radius), milestones and reward commands. A complete example (classic) ships with the mod.
• After the last phase: stay on it, or loop back to the first.
• Options per mode, which the server can force in config/oneblock_engine.json: hidden upcoming phases, machines that count (or not) when they break the block, and a block reserved for its members.
• In-game editor (/oneblock edit <mode>, operators): drag and drop to reorder phases. Add, copy and delete phases. Add blocks with a search or the block in your hand, adjust weights, mobs and reward commands. Undo and redo, simulate, copy the JSON, save. The editor keeps milestones and loot tables as they are (edit those in the JSON).
• Saving applies the mode at once and writes it to a datapack of the world. Copy that file, or use "Copy JSON", to ship it in your pack.
• Simulation: /oneblock simulate <mode> draws the blocks a player would break.
• World type "One Block". The Create World screen offers One Block next to Normal and Superflat: a totally empty world with the magic block at spawn. A pack can make it the default (default_world_type in config/oneblock_engine-client.json) and choose its mode and height with a world preset in its datapack. Dedicated server: level-type=oneblock_engine:oneblock and spawn-protection=0.
• A block or mob from a mod that is not installed is removed from its phase with a warning in the log. The pack does not crash. /reload reloads modes and settings.
• Server settings: multiplier on the blocks to break, mobs on or off, phase announcements, and more.
• Addon API (same on both loaders): OneBlockEvents with PHASE_CHANGED, BLOCK_GENERATED and MILESTONE_REACHED.

Islands and multiplayer

In a One Block world, every player gets their own island on first join, spaced along the X axis (1000 blocks by default). Other settings: a shared island for everyone, or a single block without islands.

• Roles: owner, admin, member. Up to 10 members per island by default.
• Invite an online player, or ask to join an island. Kick, ban, transfer ownership.
• Visits can be open or closed. On an island, a non-member cannot break, place, open or hit anything (except monsters).
• Press I, use "My island" in the pause menu, or /island. Tabs: My island, Invite, Requests, Banned, Islands.
• A sole owner who leaves for another island deletes theirs, after a confirmation. Their builds are erased.

Progress belongs to the block: everyone who breaks it moves it forward, so co-op needs no setup.

Loaders and version

• Minecraft 1.21.1, Fabric (Fabric API) and NeoForge.
• Install it on the server and on the players' side to get the player view and the editor. A player without the mod can still join.
• No other dependency.

Using it in a modpack

The licence is All Rights Reserved, but modpacks may include One Block Engine, on Modrinth and on CurseForge. If you want to redistribute it another way, ask us first.

Links

• Discord: https://discord.gg/9m9Et5zFB5

One Block Engine (français)

One Block Engine ajoute un bloc magique qui change à mesure que tu le casses. Chaque phase a ses blocs, ses créatures, ses coffres et ses récompenses, et tu passes à la suivante après un certain nombre de blocs cassés. Le mod contient le moteur seulement. Le contenu (phases, blocs, créatures) vient d'un mode, écrit en JSON dans un datapack ou modifié en jeu.

Fait par Eltyy, du studio Eltyy.

Pour les joueurs

• Appuie sur O (touche réglable) pour ouvrir la vue joueur : une frise des phases (finies, en cours, à venir), une barre de progression et, pour chaque phase, la chance de chaque bloc et de chaque créature.
• Les coffres et tonneaux d'une phase sont remplis avec des tables de butin. Des paliers dans une phase peuvent afficher un message et lancer des commandes (un boss, une vague, un cadeau).
• À la fin d'une phase, ses récompenses sont données au niveau du bloc.
• Commandes : /oneblock info, /oneblock view, /oneblock home, /oneblock modes. Un joueur sans le mod peut jouer : il a les commandes et les messages en texte.
• Les blocs qui tombent (sable, gravier) ont une barrière dessous pour ne pas partir dans le vide.

Pour les créateurs de modpacks

• Modes en JSON. Un mode est un fichier dans data/<espace>/oneblock/modes/ d'un datapack. Une phase a un identifiant, un nom, une icône, une couleur, un nombre de blocs à casser, des blocs pondérés, des créatures (chance par bloc, maximum dans un rayon), des paliers et des commandes de récompense. Un exemple complet (classic) est livré avec le mod.
• Après la dernière phase : rester dessus, ou revenir à la première.
• Options par mode, que le serveur peut forcer dans config/oneblock_engine.json : phases à venir cachées, machines qui comptent (ou non) quand elles cassent le bloc, bloc réservé à ses membres.
• Éditeur en jeu (/oneblock edit <mode>, opérateurs) : glisser-déposer pour réordonner les phases. Ajouter, copier et supprimer des phases. Ajouter des blocs avec une recherche ou le bloc en main, régler les poids, les créatures et les commandes de récompense. Annuler, rétablir, simuler, copier le JSON, enregistrer. L'éditeur garde tels quels les paliers et les tables de butin (à modifier dans le JSON).
• Enregistrer applique le mode tout de suite et l'écrit dans un datapack du monde. Copie ce fichier, ou utilise « Copier JSON », pour le livrer dans ton pack.
• Simulation : /oneblock simulate <mode> tire les blocs qu'un joueur casserait.
• Type de monde « One Block ». L'écran « Créer un monde » propose One Block à côté de Normal et Superflat : un monde totalement vide avec le bloc magique au point d'apparition. Un pack peut l'imposer par défaut (default_world_type dans config/oneblock_engine-client.json) et choisir son mode et sa hauteur avec un préréglage de monde dans son datapack. Serveur dédié : level-type=oneblock_engine:oneblock et spawn-protection=0.
• Un bloc ou une créature d'un mod absent est retiré de sa phase avec un avertissement dans le journal. Le pack ne plante pas. /reload recharge les modes et les réglages.
• Réglages du serveur : multiplicateur des blocs à casser, créatures oui ou non, annonce des phases, et d'autres.
• API pour les addons (la même sous les deux chargeurs) : OneBlockEvents avec PHASE_CHANGED, BLOCK_GENERATED et MILESTONE_REACHED.

Îles et multijoueur

Dans un monde One Block, chaque joueur a sa propre île à sa première connexion. Les îles sont alignées sur l'axe X (tous les 1000 blocs par défaut). Autres réglages : une île commune pour tout le monde, ou un seul bloc sans îles.

• Rôles : propriétaire, admin, membre. Jusqu'à 10 membres par île par défaut.
• Invite un joueur connecté, ou demande à rejoindre une île. Exclusion, bannissement, cession de l'île.
• Les visites sont ouvertes ou fermées. Sur une île, un non-membre ne casse, ne pose, n'ouvre et ne frappe rien (sauf les monstres).
• Touche I, bouton « Mon île » du menu pause, ou /island. Onglets : Mon île, Inviter, Demandes, Bannis, Îles.
• Un propriétaire seul qui part vers une autre île supprime la sienne, après une confirmation. Ses constructions sont effacées.

La progression appartient au bloc : tous ceux qui le cassent la font avancer, donc le coop ne demande aucun réglage.

Chargeurs et version

• Minecraft 1.21.1, Fabric (Fabric API) et NeoForge.
• À installer sur le serveur et chez les joueurs pour avoir la vue joueur et l'éditeur. Un joueur sans le mod peut quand même rejoindre.
• Aucune autre dépendance.

Dans un modpack

La licence est « tous droits réservés », mais les modpacks peuvent inclure One Block Engine, sur Modrinth comme sur CurseForge. Pour une autre redistribution, demande-nous d'abord.

Liens

• Discord : https://discord.gg/9m9Et5zFB5