Diplomacy

Manage your clan’s diplomatic relationships with allies, enemies, and NAP agreements

Overview

The Diplomacy system helps you track and manage your clan’s relationships with other clans in Last Oasis. Mark clans as allies, enemies, or NAP (Non-Aggression Pact), customize their flags, and keep your entire clan informed about who to help and who to avoid.

Key Features

• Three Relationship Types: Allies, Enemies (War), and NAP/Settlers
• Custom Clan Flags: Assign colors and symbols to other clans for easy identification
• Visual Organization: Color-coded panels (green for allies, red for enemies, yellow for NAP)
• Permission-Based Access: Leaders and designated diplomats can manage relationships
• Flag Symbol Library: Choose from 30+ symbols for clan identification

Accessing Diplomacy

1. Verify Clan Membership

   You must be in a clan to access the Diplomacy page.

   If you don’t have a clan, you’ll be redirected to your profile with an error message.

2. Check Your Permissions

   Diplomacy management is restricted to:

   • Clan Leaders: Always have full access
   • Diplomats: Members granted diplomacy permissions by the leader

   If you don’t have permission, you can view relationships but cannot create or delete them.

Relationship Types

Allies (Green)

Mark clans as Allies when:

• You have a formal alliance agreement
• You fight together in battles
• You share resources and information
• You defend each other’s bases

Visual Indicator: Green border and header

NAP / Settlers (Yellow)

Mark clans as NAP (Non-Aggression Pact) when:

• You have an agreement not to attack each other
• They’re neutral settler clans in your area
• You want to avoid conflict but aren’t allies
• You trade occasionally but don’t fight together

Visual Indicator: Yellow border and header

War / Enemies (Red)

Mark clans as War when:

• You’re actively in conflict
• They’re known griefers or enemies
• You want clan members to attack on sight
• You’ve had hostile encounters

Visual Indicator: Red border and header

Relationship types help your clan members make quick decisions in-game. Clear communication prevents friendly fire and missed opportunities.

Creating Diplomatic Relationships

1. Access the Creation Form

   At the top of the Diplomacy page (only visible to leaders and diplomats), you’ll see the relationship creation form.

2. Select Relationship Type

   Choose from the dropdown:

   • NAP or Settler (Type 0)
   • Ally (Type 1)
   • War (Type 2)
3. Choose Flag Color

   Click the color picker to select a color representing the other clan’s flag.

   This helps members identify the clan in-game by matching their flag colors.

4. Enter Clan Name

   Type the other clan’s name (max 20 characters).

   Double-check spelling. This name is what your members will see and search for.

5. Select Flag Symbol

   Scroll through the symbol grid and click on the symbol that matches the other clan’s flag.

   Available symbols: C1 through C30 (30 different designs)

6. Create Relationship

   Click “Create Relationship” to add the clan to your diplomacy list.

// Relationship creation
// Located at: src/pages/Diplomacy.tsx:88-128

Managing Existing Relationships

Viewing Relationships

The Diplomacy page shows three color-coded panels:

1. Allies Panel (Green): All allied clans
2. NAP/Settlers Panel (Yellow): All NAP agreements
3. War Panel (Red): All enemy clans

Each relationship displays:

• Clan name
• Flag color preview
• Flag symbol image
• Delete button (if you have permissions)

Deleting Relationships

Only clan leaders and members with diplomacy permissions can delete relationships.

1. Find the clan in one of the three panels
2. Click the delete button on that clan’s card
3. The relationship is immediately removed

When to delete relationships:

• Alliance ended
• NAP agreement broken
• Enemy defeated or left the server
• Clan disbanded
• Mistake in clan name or flag

Flag Customization

Why Customize Flags?

In Last Oasis, clans have customizable flags with:

• A background color
• A symbol/sigil

Matching these in Stiletto’s Diplomacy system helps your members:

• Quickly identify other clans in-game
• Make split-second friend/foe decisions
• Coordinate in large battles with multiple clans

Choosing the Right Symbol

The symbol selector shows 30 options (C1-C30):

// Symbol selection
// Located at: src/pages/Diplomacy.tsx:214-238

1. Match in-game: Choose the symbol that matches their actual flag
2. Visual preview: Click symbols to see them highlighted
3. Labeled clearly: Each symbol shows its code (C1, C2, etc.)

If you don’t know another clan’s exact flag, ask them or check during an in-game encounter.

Permission System

Granting Diplomacy Permissions

Clan leaders can grant diplomacy permissions through Clan Management:

1. Go to Members page
2. Click Edit on a member
3. Toggle “Diplomacy” permission
4. Save changes

Members with this permission can:

• Create new diplomatic relationships
• Delete existing relationships
• Modify all diplomacy settings

Use case: Assign to officers or designated diplomats who negotiate with other clans.

Permission Validation

// Permission check
// Located at: src/pages/Diplomacy.tsx:56-86

if (discordid === leaderid) {
  setHasPermissions(true);
} else {
  const permissions = await getMemberPermissions(clanid, discordid);
  setHasPermissions(permissions.diplomacy ?? false);
}

Permissions are checked:

• On page load
• Before showing creation form
• Before allowing deletions
• Server-side for security

Integration with Other Features

Clan Management

Diplomacy works closely with Clan Management:

• Leaders manage both members and diplomacy
• Diplomacy permissions are granted through member management
• Clan deletion also removes all diplomatic relationships

Resource Maps

Use diplomacy to coordinate map sharing:

• Share resource maps with allied clans
• Mark enemy base locations on maps
• Coordinate gathering in NAP territories

Trading System

Diplomatic relationships guide trading decisions:

• Trade safely with allies
• Avoid trades with enemies
• Negotiate fair prices with NAP clans

Best Practices

Diplomatic Record Keeping

1. Document agreements: Keep notes in Discord about what each relationship means
2. Update regularly: Remove disbanded clans or ended agreements
3. Announce changes: Tell your clan when diplomacy changes
4. Flag accuracy: Verify flag colors and symbols before adding
5. Consistency: Use the same relationship type everyone agrees on

Multi-Clan Politics

1. Shared enemies: Coordinate with allies on common enemies
2. NAP networks: Map out which NAPs have relationships with each other
3. Avoid confusion: If clans have similar names/flags, add notes in Discord
4. Communication: Keep allies informed of your other relationships
5. Neutrality: Some clans prefer NAP with everyone - respect that

Flag Management Tips

1. Screenshot flags: Keep screenshots of allied/enemy flags for reference
2. Symbol guide: Make a Discord channel showing all C1-C30 symbols
3. Color matching: Use in-game color picker values if possible
4. Update promptly: If a clan changes their flag, update the relationship
5. Distinctive choices: Encourage allies to choose unique flag combinations

Common Workflows

Establishing a New Alliance

1. Leaders from both clans negotiate terms
2. Exchange flag details (color and symbol)
3. Both clans add each other as Allies in Diplomacy
4. Announce the alliance in clan Discord
5. Brief members on cooperation rules (shared resources, defense, etc.)

Declaring War

1. Decide to engage in conflict with another clan
2. Add them as War relationship in Diplomacy
3. Note their flag for identification
4. Brief clan members on:
   • Rules of engagement
   • Priority targets
   • Defensive strategies
5. Update as the conflict evolves or ends

NAP Agreements

1. Contact another clan’s leadership
2. Agree on NAP terms (usually non-aggression, maybe trading)
3. Exchange flag information
4. Both clans add each other as NAP
5. Remind members: don’t attack, but don’t share sensitive info either

Cleaning Up Old Relationships

1. Review diplomacy list monthly
2. Check if clans are still active
3. Verify agreements are still valid
4. Remove defunct clans or ended agreements
5. Update any changed flags

Technical Details

Relationship Data Structure

interface RelationshipInfo {
  id: number;
  nameotherclan: string; // Other clan's name
  clanflag: string;      // Hex color code
  symbol: string;        // Symbol ID (C1-C30)
  typed: TypeRelationship; // 0=NAP, 1=Ally, 2=War
}

Relationship Filtering

Relationships are filtered client-side for instant display:

// Allies filter
const allies = listOfRelations.filter(
  (r) => r.typed === TypeRelationship.ALLY || r.typed === TypeRelationship.FALSE_ALLY
);

// Enemies filter
const enemies = listOfRelations.filter(
  (r) => r.typed === TypeRelationship.WAR || r.typed === TypeRelationship.FALSE_WAR
);

// NAP filter
const naps = listOfRelations.filter(
  (r) => r.typed === TypeRelationship.NAP || r.typed === TypeRelationship.FALSE_NAP
);

Symbol Assets

Symbols are stored as PNG images:

// Symbol images loaded from resources URL
`${config.RESOURCES_URL}/symbols/${symbol}.png`

Images are:

• Lazy loaded for performance
• Cached by the browser
• Displayed with proper alt text for accessibility

Troubleshooting

Can't access Diplomacy page

Solution:

• Verify you’re in a clan (check your profile)
• If you just joined, try logging out and back in
• Contact your clan leader to verify membership status

Can't create relationships

Solution:

• Check if you’re the clan leader
• Ask your leader if you have diplomacy permissions
• Verify you’re logged in with Discord
• Try refreshing the page

Wrong symbol selected

Solution:

• Delete the relationship
• Recreate it with the correct symbol
• There’s no edit feature currently - deletion and recreation is the workflow

Relationship not appearing in correct category

Solution:

• Check the relationship type you selected when creating
• Delete and recreate with the correct type
• If it still appears wrong, it may be a data issue - contact support

Advanced Features

False Flags

The system supports “False” relationship types:

• FALSE_ALLY
• FALSE_NAP
• FALSE_WAR

These are used for:

• Deception strategies (mark enemies as allies to infiltrate)
• Testing purposes
• Historical record keeping

False flags are advanced features. Misuse can confuse your clan members. Use with clear communication.

Bulk Management

For large-scale diplomatic operations:

1. Keep a spreadsheet of all relationships
2. Assign dedicated diplomats for different regions
3. Regular audits to ensure accuracy
4. Coordinate with allied clans to maintain consistent relationships

Future Enhancements

Potential features being considered:

• Relationship notes/descriptions
• Relationship history and change logs
• Export diplomacy list to CSV
• Import relationships from templates
• Relationship categories (regional allies, global allies, etc.)
• Automatic flag detection from in-game screenshots

Have suggestions for the diplomacy system? Share your feedback through the appropriate channels.