Diplomacy - Stiletto

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

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.

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

Access the Creation Form

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

Select Relationship Type

Choose from the dropdown:

NAP or Settler (Type 0)
Ally (Type 1)
War (Type 2)

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.

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.

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)

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:

Allies Panel (Green): All allied clans
NAP/Settlers Panel (Yellow): All NAP agreements
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.

Find the clan in one of the three panels
Click the delete button on that clan’s card
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

Match in-game: Choose the symbol that matches their actual flag
Visual preview: Click symbols to see them highlighted
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:

Go to Members page
Click Edit on a member
Toggle “Diplomacy” permission
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

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

Multi-Clan Politics

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

Flag Management Tips

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

Common Workflows

Establishing a New Alliance

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

Declaring War

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

NAP Agreements

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

Cleaning Up Old Relationships

Review diplomacy list monthly
Check if clans are still active
Verify agreements are still valid
Remove defunct clans or ended agreements
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:

Keep a spreadsheet of all relationships
Assign dedicated diplomats for different regions
Regular audits to ensure accuracy
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.

Get Started

Core Features

Game Data

Integrations

​Overview

​Key Features

​Accessing Diplomacy

​Relationship Types

​Allies (Green)

​NAP / Settlers (Yellow)

​War / Enemies (Red)

​Creating Diplomatic Relationships

​Managing Existing Relationships

​Viewing Relationships

​Deleting Relationships

​Flag Customization

​Why Customize Flags?

​Choosing the Right Symbol

​Permission System

​Granting Diplomacy Permissions

​Permission Validation

​Integration with Other Features

​Clan Management

​Resource Maps

​Trading System

​Best Practices

​Common Workflows

​Establishing a New Alliance

​Declaring War

​NAP Agreements

​Cleaning Up Old Relationships

​Technical Details

​Relationship Data Structure

​Relationship Filtering

​Symbol Assets

​Troubleshooting

​Advanced Features

​False Flags

​Bulk Management

​Future Enhancements

Build docs developers (and LLMs) love

Overview

Key Features

Accessing Diplomacy

Relationship Types

Allies (Green)

NAP / Settlers (Yellow)

War / Enemies (Red)

Creating Diplomatic Relationships

Managing Existing Relationships

Viewing Relationships

Deleting Relationships

Flag Customization

Why Customize Flags?

Choosing the Right Symbol

Permission System

Granting Diplomacy Permissions

Permission Validation

Integration with Other Features

Clan Management

Resource Maps

Trading System

Best Practices

Common Workflows

Establishing a New Alliance

Declaring War

NAP Agreements

Cleaning Up Old Relationships

Technical Details

Relationship Data Structure

Relationship Filtering

Symbol Assets

Troubleshooting

Advanced Features

False Flags

Bulk Management

Future Enhancements