Oficium

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

Primary (1 slot by default)	Secondary (2 slots by default)
Smith, Alchemist, Farmer, Explorer	Miner, Hunter, Lumberjack, Herbalist, Fisher, Gatherer, Cook

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

What	Version
Hytale server	0.7.x (Update 7), tested on 0.7.6
MMO Skill Tree	Optional
RPG Leveling	Optional

Compatibility

Mod	What happens
MMO Skill Tree	Gathering professions use its skill levels (Mining, Woodcutting, Fishing, Harvesting, Excavation), and the profession adds +50% of the XP it gives. Oficium adds four skills to it, Smithing, Cooking, Alchemy and Exploration, which mirror the profession level on its scale. Level overrides set in /mmoadmin are respected.
RPG Leveling	XP from breaking and harvesting in the profession's area is 25% higher.
Endgame & QoL	Its workbench tiers follow the same profession tiers.

None of them is required.

Commands

Command	Who	What it does
/oficium (or /ofc)	Everyone	Opens My profession
/oficium list	Everyone	Lists the server's professions
/oficium path <profession>	Everyone	Opens the path of a profession
/oficium who <profession>	Everyone	Shows who is online with a profession
/oficium repair	Smiths	Opens the free repair (once every 30 minutes)
/oficium language <en-US / pt-BR / game>	Everyone	Picks your language for Oficium (also in My profession)
/oficium admin panel	Admin	Opens the admin panel
/oficium admin npc place / remove	Admin	Places or removes the Master of Professions
/oficium admin set / clear / cooldown / level ...	Admin	Manages a player's slots and levels
/oficium admin workshop give / remove	Admin	Gives a player a new workshop, or removes it from the map
/oficium admin reload	Admin	Reloads the configuration
/oficium admin access report	Admin	Shows the actions that would be blocked most often

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.

File and key	Default	What it does
config.json → slots.primary, slots.secondary	1, 2	How many professions each player can have
config.json → cooldowns.primary, cooldowns.secondary	7d, 3d	Time before a slot can be swapped again
config.json → professions.<id>.mode	BENEFITS	TITLE_ONLY keeps the profession as a title, with no benefits or restrictions
config.json → titles.language, nameplate, chat, playerList	pt-BR, on	Where the title shows, and its language above the character
config.json → progression.maxLevel, mastery.ranks	50; Apprentice 1, Artisan 10, Master 25, Grandmaster 50	Levels and ranks
access.json → mode	ENFORCE	OBSERVE only logs what would be blocked
benefits.json	per profession	Each benefit's value at the max level, and the workshop bonus

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

Oficium	Hytale
0.2.5	0.7.x (tested on 0.7.6)
0.2.4	0.7.x (tested on 0.7.6)
0.2.3	0.7.x (tested on 0.7.6)
0.2.2	0.7.x (tested on 0.7.6)
0.2.1	0.7.x (tested on 0.7.6)

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.