Viking Earth Installation Guide - Oblivyx Studios Docs

Prerequisites

Before you begin: Ensure your server meets these requirements for optimal performance.

Minecraft Server: Spigot/Paper 1.21.11
Required Plugins: Citizens (free), ItemsAdder (paid), FAWE (free)
Optional Plugins: ViaVersion, ViaBackwards
Server RAM: Minimum 6GB (8GB+ recommended for 20+ players)
World: Earth World (~10 GB) — see installation step below

Required Dependencies

Important: The following plugins must be downloaded and placed in your /plugins folder before starting the server. All other plugins are included in the setup.

Required Plugins

ItemsAdder — Paid | Download on SpigotMC
Citizens 2.0.41 — Free | Direct Download / SpigotMC
TAB — Free | Download on Modrinth
EvenMoreFish — Free | Download on Modrinth
FastAsyncWorldEdit (FAWE) — Free | Download on Modrinth
ProtocolLib — Free | Download on SpigotMC
PacketEvents — Free | Download on Modrinth

Optional Plugins

ViaVersion — Free | Download on Modrinth
ViaBackwards — Free | Download on Modrinth

Earth Map (Extra)

Earth World Map (~10 GB) — See Step 2: Install the Earth World below for download and setup instructions.

Step-by-Step Installation

1

Download Required Files

Download the Viking Earth setup package and extract all files.

Simple Setup: Just drag and drop the setup files into your server container.

2

Install the Earth World

This setup uses the Official Earth Map, which has a large file size of approximately 10 GB. For that reason, you'll need to download the world yourself and upload it to your server.

Large Download: The Earth World map is approximately 10 GB. Make sure you have a stable internet connection and enough server disk space before proceeding.

Download the Earth World

Download the map from the official Earth World website: Click here

Recommendation: We recommend choosing: 1:1500 | 1.17.1 | OSM-Vegetation: Yes

Upload to Your Server

Once downloaded, upload the Earth world to your server's world folder.
After uploading, rename the folder to world — this is required for the setup to function properly.

3

Install Dependencies

Add the required plugins to your plugins folder. All other plugins are included in the setup.

Required Downloads: You need to download Citizens (free), ItemsAdder (paid), and FAWE (free) separately.

Citizens: Download from SpigotMC (free)
ItemsAdder: Purchase from SpigotMC (required for custom items)
FAWE: Download from GitHub (free WorldEdit alternative)

4

Rebranding

Customize the setup for your server by updating configuration files with your server's information.

Important: Update these files with your server name, Discord link, and store URLs to complete the setup.

Files to Update

Essential Configuration

/plugins/Essentials/motd.txt - Server Name, Discord, Forums & Store URL
/plugins/dMOTD/config.yml - Server Name
/plugins/dMOTD/server-icon.png - Replace with 64x64px server icon
/plugins/TAB/config.yml - Server Name, IP, Store URL

Store & Economy

/plugins/ExcellentCrates/previews/ - Store URL
plugins/DecentHolograms/holograms/PointsInformation.yml - Store URL
plugins/DeluxeMenus/gui_menus/Pointshop - Prices and other stuff

Social & Community

plugins/DeluxeMenus/gui_menus/Socails.yml - Social links
plugins/DeluxeMenus/gui_menus/ranks.yml - Store URL
plugins/DecentHolograms/holograms/Welcome.yml - Server Name

5

Start Your Server

Start your server and enjoy the Viking Earth experience!

Server Start

# Start your server
./start.sh
# or
java -jar server.jar

# Check if everything loaded correctly
/plugins

ItemsAdder Resource Pack Setup

5

Resource Pack Hosting

ItemsAdder requires a resource pack to be hosted for players to see custom textures and items. Choose one of the two methods below to host your resource pack.

Important: Only one pack hosting method can be active at a time. You cannot enable two or more methods simultaneously.

Method 1: Self-Host

Self-Host Configuration

Open plugins/ItemsAdder/config.yml and find the self-host section
Set enabled: true under the self-host section
Enter your server's numerical IP address (e.g. 192.168.1.100)
Enter a separate port in the port field — this cannot be the same as your Minecraft server port. ItemsAdder requires its own dedicated port (e.g. if your server runs on 25565, use something like 8163)

Method 2: External Host (mc-packs.net)

External Host Configuration

On first server startup, run the command /iazip in your server console or in-game
Navigate to the plugins/ItemsAdder/output/ folder on your server
Download the generated.zip file from the output folder
Upload the generated.zip to https://mc-packs.net/
Copy the generated download URL from mc-packs.net
Open plugins/ItemsAdder/config.yml and find the external-host section
Paste the URL into the external-host URL field and set enabled: true

Installation Verification

Success! If all steps completed without errors, your Viking Earth setup is ready.

Verification Checklist

✓ All required plugins loaded without errors
✓ Earth World folder is named world
✓ PvP Arena region is properly configured
✓ AFK Pond rewards system is active
✓ NPCs are spawned and responding to commands
✓ Permission groups are correctly assigned
✓ Economy and shard systems are functional

Viking Earth — Installation Guide