Oficium

Professions for Hytale servers. Every player picks a primary profession and a few secondary ones. The server decides what is free for everyone and what needs the profession. Each profession levels up, gets better at its own work and earns a title everyone can see.

Oficium is a server plugin: players install nothing. It works on its own, and when MMO Skill Tree or RPG Leveling is installed, it connects to them automatically.

Why Oficium

• Real roles on your server. A Smith forges cobalt, a Miner gets more ore, a Lumberjack chops faster. Players trade with each other because nobody can do everything.
• You decide the rules. Professions can block an activity, only log it, or just be a title with no gameplay effect. Everything is in JSON files, plus an in-game admin panel.
• Made to look like part of the game. There is an NPC with its own screens, a progression tree that uses the game's own item icons, map markers for workshops and an XP bar on the HUD.

Professions

The number of slots and the cooldown to swap each slot (7 and 3 days by default, in real time) are configurable. Swapping keeps the old profession's progress, so coming back to it later does not start from zero.

Features

Master of Professions. Players choose and swap professions at an NPC that the admin places with one command. Its screens show:

• the player's slots and the profession catalog;
• the profession path: each benefit at every rank, and what unlocks at each level, with the item icons;
• Who does it: online players who have each profession.

Access rules. Without the profession, a player can't mine, harvest, craft or smelt the restricted items, and gets a short notice explaining why. Defaults cover the base game (for example, the Smith handles metal while leather, cloth and stone stay free for everyone). Run in OBSERVE mode first to see what would be blocked before you turn it on.

Progression. Professions have XP and levels from 1 to 50, earned by doing the profession's own work. Levels unlock advanced tiers, such as cobalt for the Smith at level 10. Ranks go from Apprentice to Artisan, Master and Grandmaster. When someone reaches a new rank, everyone on the server sees it.

Benefits. Each profession improves only its own activities, and benefits do not stack between professions:

• yield: a chance of +1 when breaking, harvesting, killing, smelting or crafting materials;
• break speed;
• efficiency: a chance to get crafting ingredients back.

Benefits grow with the level up to the configured maximum.

Some professions have their own:

• Explorer: up to +20% walking speed, +50% max stamina and +50% stamina regeneration. XP for every new chunk and every named place discovered, and a discovery doubles the Explorer's XP and benefits for 10 minutes.
• Farmer: crops they plant grow up to 70% faster, on top of water, light and fertilizer, even while they are offline.

Smith's craft. /oficium repair opens the game's repair screen for free every 30 minutes, with the usual durability loss, and a Smith using the game's repair kit loses no max durability.

Artisan's signature. From Artisan on, iron-and-up equipment you craft is signed with your name and rank in the item's description.

Workshops. Choosing a primary profession gives the player a workshop block to place anywhere, usually at home. It shows on the world map with the owner's title, and working within 8 blocks of it gives a bonus (+10% by default), shown on the status bar. Each player can hide workshop icons from the map, or just from the compass, in My profession.

Titles. Titles such as "(Master Smith 27) Name" appear above the character, in chat and in the player list. Each place can be turned off.

My profession. /oficium opens the player's own screen with level, XP, rank and the next unlock. There, each player also chooses where the XP bar sits on the HUD, or turns it off.

Admin panel. /oficium admin panel opens a panel with tabs:

• Settings: slots, cooldowns, access mode, benefits and the workshop bonus;
• Progression: XP and level curve, Explorer XP and discovery bonus, Smith repair and signature, rank levels, where titles show and their language, and slot behavior;
• Players: slots and levels for any player;
• Server: one-click presets (Casual, Default, Hard) and an overview of who plays what.

Languages. English and Portuguese (Brazil). Each player picks the language of Oficium for themselves in My profession, or keeps the game's language. Screens, notices and chat messages follow that choice.

Requirements

Compatibility

None of them is required.

Commands

Admin permission: flintdl.oficium.command.oficium.admin. OPs already have it.

Installation

1. Put Oficium-<version>.jar in your server's mods folder.
2. Start the server. On the first start, Oficium creates mods/Flintdl_Oficium/ with config.json, access.json and benefits.json.
3. Place the Master of Professions with /oficium admin npc place.

Updating is just replacing the jar. Rules you never edited follow the new version, new rules are added, and your own changes stay. The previous file is kept as access.json.bak.

Back up the whole mods/Flintdl_Oficium/ folder while the server is stopped. If a player file can't be read, Oficium never resets it. It refuses that player's actions and logs which file to restore.

Configuration

Almost everything is in the admin panel, saved without restarting. The files live in mods/Flintdl_Oficium/ for what doesn't fit a screen (access rules, MMO skill ids, rank names): edit by hand and run /oficium admin reload.

Known limits

• The title above the character and in the player list, and the name of the Master of Professions NPC, show in one language for the whole server (titles.language): the game sends that text to everyone as it is.
• The Hunter has no MMO Skill Tree skill by default; it uses Oficium's own level.
• The translations have not been reviewed by native speakers yet.

Versions

Each file is marked with the Hytale update it was tested on. Hytale's server API changes between updates, so use the file that matches your update.

Português

O Oficium traz profissões para servidores Hytale. É um plugin de servidor: os jogadores não instalam nada. Cada jogador tem uma profissão primária (Ferreiro, Alquimista, Fazendeiro, Explorador) e vagas secundárias (Minerador, Caçador, Lenhador, Herbalista, Pescador, Coletor, Cozinheiro).

• O servidor decide o que é livre e o que pede a profissão. Cada profissão sobe de nível na própria área e ganha benefícios e um título visível.
• Escolher e trocar é pelo NPC Mestre das Profissões, que tem telas próprias com o caminho da profissão, "quem faz" e a sua profissão.
• O Explorador anda mais rápido e tem mais stamina; o Fazendeiro faz a plantação crescer mais rápido; o Ferreiro repara (/oficium repair, ou reparar) e, a partir de Artesão, assina o equipamento que faz.
• As oficinas aparecem no mapa (cada jogador pode escondê-las do mapa ou só da bússola), e uma barra de XP aparece na tela.
• O administrador tem um painel no jogo (/oficium admin panel) com predefinições Casual, Padrão e Difícil.
• Os textos estão em português e inglês, e cada jogador escolhe o idioma do Oficium na Minha profissão.
• O Oficium se integra sozinho ao MMO Skill Tree e ao RPG Leveling quando eles estão instalados.

License

Free to use on any number of servers, including monetized ones. You may not republish, redistribute, sell or distribute modified versions of Oficium. The full text is in the license on this page.

Support

If Oficium makes your server better, you can support its development on Ko-fi.

Oficium is not affiliated with or endorsed by Hypixel Studios.