Game systems

Clans: alliances, guilds and teams

How the ready-made iDos Games clans work - alliances, guilds and teams with roles, requests, help and clan gifts - and how to set them up in the dashboard.

Clans let players play together: create or join a clan, ask clanmates for resources, help each other and get gifts when a clanmate buys something. One module covers 4X alliances, midcore clans and casual teams.

What the player sees

  • Outside a clan: recommended clans, search by name or tag, invites and creation of their own clan.
  • Inside: the clan level and rewards for every member, the member list with roles, requests and help, clan gifts, the clan chat and the log.
  • Officers accept applications, invite, kick, change roles and pass the leadership - each by the rights of their role.

How it works

  • Join modes: open, by application or by invite only. Capacity grows with the clan level if you set it.
  • Roles are yours: from the built-in leader, co-leader, elder and member to R1-R5 of a 4X game, with your own rights.
  • Requests: a member asks for a resource you allow (cards, lives, coins), clanmates donate and get a reward; help speeds up a task with one tap.
  • Clan gifts: a clanmate's purchase gives a gift to the whole clan; gift points raise the gift level.
  • The server owns limits, rights, cooldowns and tenure for rewards. Crypto never goes through clans.

Items and the board

For games where items are upgraded rather than collected:

  • Item request: a player asks for a copy of their own item at its level, and a clanmate gives their own copy of the same level. The server never creates new items. You set the level cap, the cooldown (for example once a day), how many a member may give and how long they must be in the clan before the first gift.
  • No attacks on your own: clanmates and allies are never picked as attack or raid targets on the board.
  • Team chest collects points from attacks, raids, building and item upgrades. When a tier is close, members who have not contributed yet get a push.
  • Invite to a clan: a set number of hours after sign-up, the game suggests joining to a player without a clan.
  • Join in one tap: the game offers the most active open clan in the player's language.
  • Revenge for a clanmate: when an outsider attacks a member, any clanmate can tap Revenge, and the attacker becomes the target of their next attack or raid. You set how many hours revenge stays open and how many times a day a member can take it.
  • Removing inactive members: a member who has not played for the set number of days leaves the clan and frees the slot. The leader is never removed.
  • Clan messages in chat: joined, helped, new level, chest tier opened. When the clan opens a chest tier, members who earned a share get a push.
  • Items with level by mail: in the mail settings you can let players send their own upgraded items to a friend. The item arrives with its level, and if the friend declines, it goes back to the sender.

Playing together

  • Clan quests: shared quests the whole clan moves, a quest board where each member takes a quest and fills the clan scale, or the same daily quests for everyone.
  • Clan events: a team chest with reward tiers for the whole clan, or a clan boss with attempts per day and rewards for every member who hit it.
  • Projects: members put resources into shared upgrades (alliance tech, a clan capital); each level gives the whole clan bonuses and rewards.
  • Treasury: clan currencies earned by playing and by deposits. Officers spend them on clan buffs, projects and event starts. The treasury is never paid out to single players.
  • Clan bonuses work in the rest of the game: rewards and prices change for members, offers and events can be shown only to clan members, and gifts, card trades and private messages can be limited to clanmates.

Clan against clan

  • Competitions: a duel of two clans with a theme of the day, a battle of up to 20 clans, a league where clans of one level compete, or a clan war where members attack the enemy roster and take stars.
  • Points come only from playing (your game's events), each member has a daily cap. The server picks rivals by league and power and never puts allied clans in one bracket.
  • At the end every member gets rewards for the clan's place and their own tiers. The clan's league rating goes up or down with the place and with clan events.
  • Diplomacy: officers propose alliances and pacts, the other clan accepts; enemies are declared one-sided. You set how many of each a clan may have.
  • League seasons: at the end of a season the clan rating is partly reset (you set how much stays), and every member claims the reward of the league the clan finished in.
  • War with heroes: the server computes the fight and the game shows it on its own arena. Stars count right away.

Step 01Add the system to your project

Ask the AI coder to add clans, or pick the Clan system when you create a project. Its tab is hidden until clans are turned on.

Step 02Set it up in the dashboard

Open the dashboard, pick your project and go to Live Operations → v2 → Clans.

  • Pick a genre template: 4X alliance, midcore clan, casual team or board team. It fills everything; then edit it.
  • The Board with item upgrades template turns all of this on at once: free dice from the clan, an item of the needed level once a day, a team chest and protection for clanmates.
  • Set the word players see, the creation price, join modes, roles, levels, requests and gifts.
  • The Moderation tab finds any clan, resets its name or description, kicks, changes the leader, hides or disbands it.
  • The Treasury, Projects, Activities and Clan quests tabs set up playing together; in Moderation you can also correct a clan treasury.
  • The Competitions, Leagues and Diplomacy tabs set up clan against clan: competition type, schedule, bracket size, rewards for places, league tiers and limits of alliances.

The AI button on the page opens an assistant: describe what you need, it proposes changes, and you review them and press Save.

Step 03Test and release

Check the system in the test version of your app. Settings go to the live app as a separate action - see publishing and links.

For developers

Clans work through client.clan in @idosgames/core.

TypeScript
// My clan of every kind, then a request to clanmates and a donation to someone else's
const my = await client.clan.getMyClans()
await client.clan.createRequest('coins', { resource: { Type: 'VirtualCurrency', CurrencyID: 'CO' } })
await client.clan.donate(requestID, 1)
  • Your own clan data (a raid board, a war map) goes to a data collection with the Clan access rule: members read, roles with the right permission write.
  • Your own permissions (for example start_rally) come back in the member's permissions; CloudCode checks them with server.HasClanPermission.
  • Clan events (joined, donated, level up) can run your CloudCode function.
  • Playing together: getClanQuests, takeClanQuest, getActivities, submitActivityScore, contributeToProject, depositToTreasury and the claim…Rewards calls.
  • Clan against clan: getCompetitions, registerForCompetition, getBracket, startWarAttack, claimCompetitionRewards, getDiplomacy, setDiplomacy. War stars come only from your server (CloudCode server.ReportClanWarAttack) or from the engine's own battle.

Every field is described in the clan-system skill, served by the SDK MCP server.

Frequently asked questions

Can my game call clans an alliance or a team?

Yes. The word the player sees is set in the dashboard for each kind of clan; the code never says "clan".

Can players give each other resources inside a clan?

Yes, through requests: a player asks, clanmates donate. Free requests like lives are possible too, with a daily cap.

See also

Make your own game

Describe the idea in a sentence - the AI coder builds it, and it goes live at its own link.