Clan Management

Manage your Last Oasis clan members, handle join requests, and configure permissions

Overview

The Clan Management system provides comprehensive tools for running a Last Oasis clan. Leaders can manage members, process join requests, configure member permissions, transfer leadership, and more.

Key Features

• Member Management: View all clan members with their Discord tags and in-game names
• Join Request System: Review and approve/reject clan applications with custom messages
• Permission System: Grant specific permissions to members (bot access, diplomacy, kick members, etc.)
• Leadership Transfer: Transfer clan ownership to another member
• Clan Configuration: Edit clan name, flag, region, and other settings
• Clan Deletion: Disband the clan with proper warnings and confirmations

Accessing Clan Management

1. Navigate to Members Page

   From your profile, click on the Members or Clan Management link.

   You must be in a clan to access this page. If you don’t have a clan, visit the Clan List to find one.

2. View Your Permissions

   The interface adapts based on your role:

   • Clan Leader: Full access to all features
   • Member with Permissions: Access to features you’ve been granted
   • Regular Member: View-only access to member list

Member Management

Viewing Members

The member list displays:

• Discord Tag: Member’s Discord username
• In-Game Name: Their Last Oasis character name
• Actions: Kick and edit permissions buttons (if you have access)

// Member list rendering
// Located at: src/pages/MemberList.tsx:212-228

Kicking Members

Leaders and members with kick permissions can remove members:

1. Find the member in the list
2. Click the Kick button
3. Confirm the action

Kicked members lose all clan access immediately. They can reapply through the join request system.

Editing Member Permissions

Only clan leaders can edit member permissions.

1. Click the Edit button next to a member’s name
2. The Member Permissions modal opens
3. Toggle permissions:
   • Bot Access: Allow member to configure Discord bot settings
   • Handle Requests: Allow member to approve/reject join requests
   • Kick Members: Allow member to remove other members
   • Diplomacy: Allow member to manage ally/enemy relationships
4. Save changes

Join Request System

Viewing Requests

The Request List shows:

• Pending applications from players wanting to join
• Discord tag and in-game name
• “Show Request” button to view their application message

Processing Requests

1. View Request Details

   Click “Show Request” to see the applicant’s message explaining why they want to join.

2. Make a Decision

   In the request modal:

   • Accept: Add the player to your clan immediately
   • Reject: Decline the application (player can reapply later)

   Accepted members appear in the Member List immediately. They can now access clan features.

// Request processing logic
// Located at: src/pages/MemberList.tsx:143-168

Who Can Process Requests?

• Clan leaders (always)
• Members with “Handle Requests” permission

Clan Configuration

Only clan leaders can access clan configuration.

Click the Clan Configuration button to edit:

Basic Information

• Clan Name: Update your clan’s display name
• Region: Set your clan’s primary region (EU, NA, OCE, etc.)
• Discord Invite: Add your clan Discord server invite link
• Flag Color: Choose your clan’s banner color
• Flag Symbol: Select your clan’s symbol/icon

Visibility Settings

• Public/Private: Control whether your clan appears in the public clan list
• Recruitment Status: Mark your clan as recruiting or closed

Advanced Settings

Depending on your setup, you may have:

• Discord bot integration settings
• Webhook configurations
• Additional customization options

Leadership Transfer

Leadership transfer is permanent and cannot be undone. The new leader will have full control of the clan.

1. Select New Leader

   In the Transfer Clan panel:

   1. Choose a member from the dropdown
   2. Review the warning message
2. Confirm Transfer

   Click “Change Leader” to transfer ownership.

   After transfer:

   • The selected member becomes the clan leader
   • You become a regular member
   • The new leader can now manage all clan settings

// Leadership transfer
// Located at: src/pages/MemberList.tsx:191-210

Deleting Your Clan

Clan deletion is permanent and cannot be reversed. All members will be removed and all clan data will be lost.

1. Access Delete Panel

   Only clan leaders see the Delete Clan panel at the bottom of the page.

2. Understand the Consequences

   Before deleting:

   • All members will be removed from the clan
   • All clan settings and data will be deleted
   • Clan name becomes available for others to use
   • Diplomacy relationships will be lost
   • Resource maps owned by the clan may be affected
3. Confirm Deletion

   Click the Delete button and confirm. Your clan will be immediately disbanded.

Permission System Explained

Bot Access

Allows members to:

• Configure Discord bot settings
• Set up webhooks and notifications
• Manage bot integrations

Use case: Give to members who help with Discord server management

Handle Requests

Allows members to:

• View join requests
• Accept or reject applicants
• Process recruitment applications

Use case: Give to recruiters or officers who help grow the clan

Kick Members

Allows members to:

• Remove other members from the clan
• Manage member roster

Use case: Give to trusted officers for moderation

Members with kick permission can remove anyone except the leader. Use this permission carefully.

Diplomacy

Allows members to:

• Add allies, enemies, and NAP relationships (see Diplomacy)
• Modify existing diplomatic relationships
• Remove diplomatic entries

Use case: Give to diplomats or officers who coordinate with other clans

Joining a Clan

From the Clan List

If you’re not in a clan:

1. Navigate to the Clan List page
2. Search for clans by name or filter by region
3. Click “Send Request” on a clan you want to join
4. Write a message explaining why you want to join
5. Submit your request
6. Wait for the clan’s leadership to review your application

// Sending join requests
// Located at: src/pages/ClanList.tsx:75-85

Creating Your Own Clan

From your profile page:

1. Click “Create Clan”
2. Enter clan details (name, region, etc.)
3. Customize your flag (color and symbol)
4. Set visibility and recruitment status
5. Create your clan - you’ll be the leader

Integration with Other Features

• Diplomacy: Manage clan relationships (see Diplomacy)
• Resource Maps: Share maps with clan members using clan coordination
• Trading System: Clan members can coordinate trades
• Auction Timers: Coordinate auction sniping with clan members

Best Practices

Permission Management

1. Start restrictive: Only give permissions as needed
2. Trust gradually: Grant more permissions to proven members
3. Review regularly: Audit permissions monthly
4. Document roles: Keep a list of who has what permissions and why
5. Communicate: Tell members when you grant/revoke permissions

Recruitment

1. Clear expectations: In your clan description, state requirements (activity, timezone, playstyle)
2. Prompt responses: Process join requests quickly to keep applicants engaged
3. Ask questions: Use the request message to learn about applicants
4. Trial periods: Accept new members but watch their activity before granting permissions
5. Rejection messages: Consider reaching out to rejected applicants with feedback

Clan Growth

1. Onboarding: Have a process for welcoming new members
2. Discord integration: Connect your clan Discord for better coordination
3. Active leadership: Regularly review member activity and engagement
4. Promote from within: Identify active members and give them responsibilities
5. Clean inactive members: Periodically remove members who haven’t logged in

Common Workflows

Weekly Clan Maintenance

1. Review and process join requests
2. Check member activity
3. Remove inactive members (if desired)
4. Review permissions
5. Update clan description/settings if needed

Preparing for Leadership Transfer

1. Announce your intention to step down
2. Identify potential successors
3. Grant them permissions temporarily to test
4. Brief the new leader on all clan operations
5. Transfer leadership
6. Stay available to help the new leader

Handling Member Issues

1. Minor issues: Talk to the member privately
2. Moderate issues: Revoke specific permissions
3. Major issues: Kick the member
4. Document decisions: Keep notes on why actions were taken

Technical Details

Data Caching

Member data is cached for performance:

// Cache management
// Located at: src/pages/MemberList.tsx:124-141

Caches are cleared when:

• Members are kicked
• Join requests are processed
• Leadership is transferred
• Clan is deleted

Permission Checks

Permissions are verified server-side on every action. The UI hides buttons for actions you can’t perform, but the server also validates permissions.

Even if someone modifies the UI to show hidden buttons, they can’t perform actions without proper permissions.

Troubleshooting

Can't see the Members page

Solution: Make sure you’re in a clan. Check your profile to verify clan membership. If you’re not in a clan, join one from the Clan List.

Can't kick a member

Solution: Check if you have kick permissions. Only the leader and members with kick permission can remove members. You also cannot kick the clan leader.

Join requests not appearing

Solution: Make sure your clan is set to public and recruiting in clan settings. Check that you have permission to view requests.

Leadership transfer failed

Solution: Ensure you’re the current leader. The selected member must be an active clan member. If it still fails, try logging out and back in.