Adding a
Package

Overview

Packages are the items that players can purchase through your donation store. Each package can contain multiple actions that will be executed when a player makes a donation.

Accessing Package Management

1. Log into your Nexus Donate admin dashboard
2. Navigate to the "Packages" section
3. Click "Add New Package" or "Create Package"

Package Configuration

Basic Information

Package Name: VIP Package
Description: Get VIP status and special items
Price: $10.00
Category: VIP
Server: My Gaming Server
Status: Active

Required Fields

• Package Name: A descriptive name for the package
• Description: What the package includes
• Price: The cost of the package
• Server: Which server this package applies to

Optional Fields

• Category: Group packages by type
• Image: Package thumbnail image
• Status: Active/Inactive
• Sort Order: Display order on the store

Package Actions

Actions are what happens when a player purchases the package. You can add multiple actions to a single package.

Adding Actions

1. Click "Add Action" in the package editor
2. Select the action type (Give Item, Execute Command, etc.)
3. Configure the action parameters
4. Set the action delay (if needed)
5. Save the action

Action Types

• Give Item: Give players specific items
• Execute Command: Run server commands
• Give Permission: Grant special permissions
• Give Currency: Add in-game currency
• Custom Action: Custom plugin actions

Package Examples

VIP Package

Package: VIP Package
Price: $15.00

Actions:
1. Give Permission: vip.access
2. Give Item: weapon_ak47
3. Give Item: armor_kevlar
4. Execute Command: sm_give %player% vip_kit
5. Give Currency: 10000

Starter Package

Package: Starter Package
Price: $5.00

Actions:
1. Give Item: weapon_pistol
2. Give Item: ammo_pistol
3. Give Item: health_kit
4. Give Currency: 5000
5. Execute Command: sm_teleport %player% spawn

Premium Package

Package: Premium Package
Price: $25.00

Actions:
1. Give Permission: premium.access
2. Give Item: weapon_awp
3. Give Item: weapon_ak47
4. Give Item: armor_kevlar
5. Give Item: grenade_he
6. Give Currency: 25000
7. Execute Command: sm_give %player% premium_kit

Package Categories

Organize your packages into categories for better store navigation:

Common Categories

• VIP: VIP status and benefits
• Weapons: Weapon packages
• Currency: In-game money packages
• Starter: New player packages
• Premium: High-value packages

Package Pricing

Set appropriate prices for your packages:

Pricing Strategies

• Starter Packages: $1-$5 for new players
• Standard Packages: $5-$15 for regular players
• Premium Packages: $15-$50 for dedicated players
• Ultimate Packages: $50+ for maximum value

Package Testing

Always test your packages before making them available:

Test Process

1. Create a test package with a low price
2. Purchase the package yourself
3. Verify all actions execute correctly
4. Check server console for any errors
5. Test on different servers if applicable

Package Management

Manage your packages effectively:

Package List

• View all packages in a single list
• See package status and sales data
• Edit package settings
• Duplicate packages for quick creation

Package Analytics

• Track package sales
• Monitor popular packages
• Analyze revenue per package
• Identify underperforming packages

Best Practices

• Clear Descriptions: Make package contents clear to players
• Fair Pricing: Price packages appropriately for your server
• Regular Testing: Test packages regularly for issues
• Category Organization: Use categories to organize packages
• Action Order: Order actions logically (permissions first, then items)