Viking Depths requires Minecraft 1.19 or later, with 1.20.x being the recommended version for optimal performance. The setup is compatible with both Spigot and Paper servers, though Paper is recommended for better performance and additional features.

# Check your server version
/version

# Recommended server versions:
- Paper 1.20.4+
- Spigot 1.20.4+

The core required plugins for Viking Depths are:

• WorldGuard: For region protection and arena management
• LuckPerms: For permission management
• Vault: For economy integration
• Citizens: For NPC functionality (recommended)
• PlaceholderAPI: For dynamic text and statistics

Without these plugins, core features like the PvP Arena, permissions system, and NPCs will not function properly.

Yes! Viking Depths is designed to be compatible with existing servers. However, you should:

1. Create a full backup of your server before installation
2. Ensure you have available space for the arena and pond structures
3. Check for plugin conflicts, especially with other economy or region plugins
4. Test the installation on a staging server first if possible

Common WorldEdit issues during Viking Depths installation:

• Permissions: Ensure you have worldedit.* permission
• Selection: Make a proper selection before pasting schematics
• File location: Schematics must be in the correct WorldEdit folder
• Version compatibility: Use WorldEdit compatible with your server version

# Check WorldEdit status
//version

# Proper schematic loading process
//schematic load viking-arena
//paste -a  # Use -a flag to include air blocks

The AFK Pond rewards system works based on time spent in the designated area:

• Players must be within the pond region boundaries
• Rewards are given at specific time intervals (5min, 15min, 30min, etc.)
• Players must be actively connected (not truly AFK for extended periods)
• Bonus multipliers apply for longer stays

The system automatically detects when players enter and leave the pond region using WorldGuard flags.

Viking Depths features three distinct currencies:

• Money: Earned through jobs, daily rewards, trading, and selling items. Used for general purchases, gambling, and bounties.
• AFK Shards: Earned only by spending time in the AFK Pond. Used for exclusive items at the shard shop.
• Points: Earned only through the server webstore purchases. Used for premium items, cosmetics, and server perks.

All currencies are NOT lost on death, logout, or server restarts.

PvP challenges may fail for several reasons:

• Permissions: You need viking.arena.challenge permission
• Location: Both players must be near the arena entrance
• Player status: Target player might be in combat, busy, or have PvP disabled
• Arena availability: The arena might be occupied by other players

# Check arena status
/arena status

# Challenge a player
/challenge PlayerName

# View your PvP settings
/arena settings

NPCs in Viking Depths can be interacted with in several ways:

• Right-click: Opens the main interaction menu
• Commands: Use specific commands like /shardshop
• Chat: Some NPCs respond to keywords in chat when nearby

If NPCs aren't responding, check that Citizens plugin is loaded and you have the required permissions.

Performance issues after installation can usually be resolved by:

• Memory allocation: Ensure your server has at least 4GB RAM allocated
• Plugin conflicts: Check for conflicts with other plugins
• WorldGuard regions: Optimize region flags and reduce unnecessary checks
• Database optimization: Use efficient storage for player data

# Check server performance
/tps
/mem

# Check plugin performance
/timings on
/timings report

# Optimize WorldGuard
/rg flag __global__ use -g nonmembers deny

Permission issues are common and can be fixed by:

1. Verify LuckPerms is properly installed and loaded
2. Import the Viking Depths permission configuration
3. Assign players to the correct groups
4. Check for permission inheritance issues

# Check user permissions
/lp user YourName info
/lp user YourName permission check viking.shards.check

# Fix common permission issues
/lp group default permission set viking.basic true
/lp user YourName parent set default

NPC issues are typically caused by:

• Citizens plugin: Not installed or incorrectly configured
• Chunk loading: NPCs may despawn if chunks aren't properly loaded
• World changes: World edits or resets can remove NPCs
• Plugin conflicts: Other plugins may interfere with Citizens

# Check NPC status
/npc list

# Reload NPCs
/citizens reload

# Recreate missing NPCs
/npc create ShardMerchant
/npc skin ShardMerchant Viking_Trader

Economy problems are usually related to Vault configuration:

• Ensure Vault plugin is installed and loaded
• Verify an economy plugin (like EssentialsX) is connected to Vault
• Check that currency formatting is correct
• Test basic economy commands first

# Test economy integration
/balance
/eco give YourName 100

# Check Vault status
/plugins Vault
/vault-info

Absolutely! Viking Depths structures are fully customizable:

• Arena modifications: Use WorldEdit to reshape the arena
• Pond adjustments: Resize or relocate the AFK pond
• Region updates: Adjust WorldGuard regions to match changes
• Theme variations: Adapt blocks and decorations to your server theme

Remember to update region boundaries and NPC locations if you make significant changes.

Shard rewards can be customized in the plugin configuration:

1. Edit the Viking Depths config file
2. Modify the reward amounts for different time intervals
3. Adjust bonus multipliers for VIP players
4. Set custom rewards for special events

# Example configuration changes
afk-pond:
  rewards:
    5-minutes: 2    # Changed from 1
    15-minutes: 5   # Changed from 3
    30-minutes: 10  # Changed from 7
  vip-multiplier: 2.0  # Double rewards for VIP

Yes! NPCs are fully customizable using Citizens commands:

• Create new NPCs: Use /npc create [name]
• Move existing NPCs: Use /npc tphere
• Change skins: Use /npc skin [name] [skin]
• Add commands: Use /npc command add [command]

You can create NPCs for additional services like banks, auction houses, or quest givers.