discordpermsync

DiscordPermSync — Changelog

v1.0.0

Date: 2026/01/13

Added

• Clearer team + role linking (Discord → In-game teams): The script can now map Discord roles to in-game teams using a simple teams.map list.

• Priority-based team selection: If a player has multiple mapped roles, the script picks the team with the highest priority.

• Periodic syncing: Automatic re-checking every periodicSyncSeconds so players update without rejoining.

• Config-first setup: Everything required for Discord login, verification, and sync behavior is configurable inside the config file.

• Cleaner config structure + easier to read layout: Reduced confusion for first-time setup and future edits.

Improved

• Smoother Discord linking flow: Verification and linking is more consistent, and in-game team results display more reliably after linking.

• Better compatibility + stability: General improvements to reduce failed syncs and startup issues.

• Cleaner layering/structure: Better internal flow so actions happen in the right order (connect → verify → assign/sync).

Fixed

• Fixed an issue that could occur when using the mod/script that caused syncing to fail unexpectedly in certain setups.

How the script works (simple)

1. Bot connects to Discord using your discord.token and reads your server (guildId).

2. Player verifies/links (via the verify channel or DM, depending on config).

3. Script checks the player’s Discord roles.

4. Script matches roles against your teams.map.

5. Player is assigned to the correct in-game team, using highest priority if multiple matches.

6. Script keeps syncing every periodicSyncSeconds.

How to add roles to the game (Team Sync config)

Put your Discord role IDs into roleId, and your in-game team name into teamName.

"teams": {
  "enableTeamSync": true,
  "periodicSyncSeconds": 20,
  "map": [
    {
      "roleId": "####",
      "teamName": "TeamOwner",
      "priority": 3
    },
    {
      "roleId": "####",
      "teamName": "TeamStaff",
      "priority": 2
    },
    {
      "roleId": "####",
      "teamName": "TeamMember",
      "priority": 1
    }
  ]
}

Notes

• Higher priority wins. (Owner > Staff > Member)

• teamName must match your in-game team name exactly.

• Keep sync fast but reasonable (20 seconds is fine for most servers).

Discord config (what each setting does)

"discord": {
  "token": "###",
  "guildId": "####",
  "memberRoleId": "###",
  "verifyChannelId": "##",
  "allowVerifyInDM": true,
  "enableGuildMembersIntent": true,
  "registerSlashCommands": true
}

What these mean

• token: Your bot token.

• guildId: Your Discord server ID.

• memberRoleId: Role given after verify (optional depending on your setup).

• verifyChannelId: Where verify commands/messages happen.

• allowVerifyInDM: Allow verifying in DMs (good for privacy).

• enableGuildMembersIntent: Needed for reliable role checks in most setups.

• registerSlashCommands: Auto-registers bot slash commands for easy setup.