Minecraft Datapacks

A small collection of hand-made Minecraft Java Edition datapacks (plus one resource pack) built for private servers and now shared for anyone to use, learn from, or extend. Everything here is written in vanilla .mcfunction command scripting — no external plugins required (except where noted).

All packs target Minecraft Java 1.16.x (pack_format 6, i.e. 1.16.2 – 1.16.5).

Author: Azzam Al-Mutairi (@azzamalmutairi) License: MIT

---

What's inside

Folder	Type	What it does	MC version
arena-red-vs-blue/	Datapack	Red vs Blue team PvP arena, best-of-3 rounds, 6 random weapon kits	1.16.x (pack_format 6)
hotel-restaurant/	Datapack	Multiplayer hotel & restaurant tycoon system (claim plots, hire NPC staff, rent rooms, earn income)	1.16.5 (pack_format 6)
welcome-greeting/	Resource pack	Custom server welcome-greeting sound (custom.welcome)	1.16.x (pack_format 6)

Note: welcome-greeting is technically a resource pack (it ships an assets/ sound, not a data/ folder). It's kept in this repo as a companion asset — install it as a resource pack, not a datapack (see below).

---

Datapack details

1. Arena — Red vs Blue (arena-red-vs-blue/)

A round-based team PvP minigame. Players split into a Red and a Blue team, spawn into an arena, and fight; the first team to win 2 rounds wins the match (best-of-3). Every time a player (re)spawns they receive one of 6 randomly chosen loadouts, and dead players drop to spectator to watch their team until the round ends.

Highlights:

• Scoreboard-driven game state machine (lobby → fighting → between-rounds → end).
• Live sidebar showing Red wins / Blue wins / current round.
• Death handling: dead players become spectators and get teleported to a living teammate; keepInventory is used so kits don't scatter on death.
• Inventory safety: a joining player's real inventory is stashed in their ender chest slot and restored automatically when the match ends (or via arena:reset).
• Firework victory celebration and title/sound feedback throughout.
• Six kits: Sniper, Rusher, Soldier, Demolition, Ninja, Elite — each with its own armor tier, weapons, ammo, and buffs.

Requirements / caveats (please read before using):

• Requires the "Timeless and Classics" (TaC) guns mod. Every kit gives weapons and ammo with tac: item IDs (e.g. tac:ai_awp, tac:m16a1, tac:rpg7). Without that mod installed, kits will give nothing. You can swap the replaceitem lines for vanilla items (swords, bows, etc.) if you'd rather keep it vanilla.
• Map-specific coordinates. Spawn points, the lobby, join buttons and firework locations are hardcoded to a specific pre-built arena (around x≈2478, z≈2481). To use it on your own map, either build at those coordinates or edit the coordinates in the functions.
• Join buttons need command blocks. Players join by pressing buttons wired to command blocks that run arena:join_red / arena:join_blue; those functions look for the nearest player to a fixed button position, so you'll need to place the buttons/command blocks to match.
• WIP polish: several functions still contain [DEBUG] tellraw lines (in join_red, join_blue, random_kit) that print internal status to chat. They're harmless but you'll probably want to delete them for a clean player experience.

Run /function arena:reset at any time for an emergency reset that restores everyone's inventory and returns them to the lobby.

2. Hotel & Restaurant tycoon (hotel-restaurant/)

A large, mostly complete multiplayer "public server" hotel and restaurant management system (~130 functions). Its in-game text is in Arabic ("فندق ومطعم المدينة" — "City Hotel & Restaurant") and it supports up to ~50 independent player-owned hotels (plots) on one world.

What players can do:

• Claim a plot with a planning wand: /function hotel:plot/start gives a wand; right-click the 4 corners of your land, then finalize.
• Buy a license from an NPC mayor (a spawned villager) for an emerald to register your hotel or restaurant, receiving a starter kit.
• Build rooms by registering iron doors with a wand: each door becomes a numbered room with its own key, and doors open automatically for the holder of the matching key.
• Hire NPC staff placed via spawn eggs — reception, housekeeper, waiter — that respond to guests.
• Rent to guests: reception hands out a random room key (temporary stay) or a master key (permanent membership); a room-service bell (carrot-on-a-stick) lets guests call staff.
• Earn income automatically — payouts land in the owner's inventory, and accrue while offline to be paid out on next login.

Admin/utility commands: /function hotel:help (full in-game command list), /function hotel:reset_me (wipe just your own data), and /function hotel:uninstall (tear the system down). Guest management is done via tags (/tag <player> add hotel_guest / hotel_permanent).

Caveats: it's built around custom items using CustomModelData values (e.g. 201/202/311/401/411) for wands, vouchers and bells, so a matching resource pack gives the best experience, but it works functionally without one. It's Arabic-first in its messages. Designed and tested on 1.16.5.

3. Welcome greeting sound (welcome-greeting/) — resource pack

A tiny resource pack that adds one custom sound event, custom.welcome, backed by assets/minecraft/sounds/custom/welcome.ogg. Pair it with a datapack or command block that runs, e.g.:

/playsound custom.welcome master @a

to play a custom greeting when players join your server. This is the smallest pack here and is a good starting point if you want to learn how custom sounds are wired up.

---

Installing a datapack

1. Open your world save folder (single-player: .minecraft/saves/<world>/; server: your server's world/ folder).
2. Drop the datapack folder (e.g. arena-red-vs-blue) into that world's datapacks/ directory. The final path should look like world/datapacks/arena-red-vs-blue/pack.mcmeta.
3. In-game, run /reload (or rejoin the world). Confirm it loaded with /datapack list.

Installing the resource pack (welcome-greeting)

1. Copy the welcome-greeting folder into your .minecraft/resourcepacks/ directory (or zip it first — both a folder and a .zip work).
2. Enable it in Options → Resource Packs.

---

Contributing / extending

These started as personal server projects, so they're honest about their rough edges (hardcoded coordinates, debug lines, mod dependencies). Pull requests that make them more portable — parameterizing coordinates, adding a vanilla-only kit option, or translating the hotel system — are very welcome. Fork freely; it's all MIT.

---

بالعربي

مجموعة صغيرة من داتا باكات ماينكرافت (نسخة جافا) صنعها عزام المطيري لسيرفراته الخاصة، ويشاركها الآن للجميع. كلها مكتوبة بأوامر .mcfunction بدون إضافات خارجية (ما عدا ما ذُكر). كل الحزم تستهدف ماينكرافت جافا 1.16.x.

• arena-red-vs-blue — لعبة قتال جماعي (أحمر ضد أزرق)، أفضل من 3 جولات، مع 6 عُدد سلاح عشوائية. تتطلب مود الأسلحة Timeless and Classics (TaC)، وإحداثيات الساحة ثابتة على خريطة معيّنة، وفيها بعض رسائل التصحيح [DEBUG] التي يُفضّل حذفها (قيد التحسين).
• hotel-restaurant — نظام إدارة فنادق ومطاعم متعدد اللاعبين (حتى 50 قطعة أرض): احجز أرضك بعصا التخطيط، اشترِ ترخيصاً من موظف البلدية، سجّل الغرف بالمفاتيح، وظّف موظفين (رسبشن/خادم غرف/نادل)، واستلم دخلك تلقائياً. رسائله بالعربية، وُضع واختُبر على 1.16.5. اكتب /function hotel:help داخل اللعبة لقائمة الأوامر.
• welcome-greeting — حزمة موارد (Resource Pack) وليست داتا باك: تضيف صوت ترحيب مخصص custom.welcome يُشغّل بأمر /playsound custom.welcome master @a.

طريقة التثبيت: ضع مجلد الداتا باك داخل world/datapacks/ ثم نفّذ /reload داخل اللعبة. أما حزمة الموارد فتوضع في .minecraft/resourcepacks/ وتُفعّل من إعدادات اللعبة.

الرخصة: MIT — استخدمها وطوّرها بحرية.