Files
Viano-Core/doc/clientless/worgen-recruitment.md
T
Nico 0173a434f4 Improve AdventureBot recruitment, world presence and performance
Manage Arthoran as a persistent level-60 tank profile, add Worgen forms and mounts, enable PvP and recruit through native LFG with preparation actions and player invitations.

Reduce repeated route and flight-planning work, bound failed-travel retries and add runtime timing diagnostics. Include 86 passing tests and measurements with 110 online bots.
2026-10-29 01:36:35 +01:00

3.1 KiB

AdventureBot world presence and recruitment

Adventure controllers maintain native voluntary PvP flags, including the saved CHARACTER_FLAG_PVP_DESIRED flag. Native faction, sanctuary and attack-validity checks still decide whether a target can be attacked. DungeonBots are unchanged.

Worgen use native Altered Form during adventure, dungeon and raid activity, combat and mixed player instances. At arrival for quiet activities, one random form is chosen and retained; mounting, transport, flying, casting and death defer the change until safe. Failed changes retry at most once every five seconds. Logout clears pending presentation state.

A Worgen in altered form uses native Running Wild (87840) for ground travel. Human form uses a horse; Brown Horse (458) and Two Forms (68996) are learned where appropriate. Existing generated profiles with empty mount dictionaries can still use these Worgen mounts. New generated Worgen profiles contain horses. Dismounting removes the Running Wild aura before restoring normal run speed. Flying continues through the existing native flight subsystem.

Recruitment uses native localized LookingForGroup channel ID26 (SucheNachGruppe in deDE), with native capital eligibility. Test config Channel.RestrictedLfg=0 allows already grouped players and recruiting bot leaders to join. No custom channel with a reserved standard-channel name is created. Human chat text is not parsed as bot recruitment commands. Bot coordination uses structured intent and party state. Announcements now include the actual next activity and destination; logs contain GROUP_CHANNEL for diagnosis. The entire bot population shares a 15-second channel limit, with each advertiser waiting three to five minutes.

During groupformation, the normal microaction executor can now run. The additive migration sql/custom/world/2026_10_29_01_adventure_group_preparation.sql adds gear checks, listening, local NPC contact, gestures and bounded searches. Search walks use verified MMAP paths, remain within an 18-yard path budget and return to their origin; they also work indoors. Combat, native travel and group following retain priority. Meeting points and group transition deadlines remain unchanged.

Bot leaders can invite nearby, visible, same-faction human players who are not AFK, grouped, already invited, in combat or in transit. A whisper describing the next activity and actual destination precedes the native party invitation. A shared ten-minute per-player cooldown limits invitations across all bots. Native party capacity and pending invitations are respected. On acceptance, the existing player-leadership policy still transfers leadership to the human player.

Compilation and production-method adapter tests cover PvP persistence requests, Worgen decisions and deferral, Running Wild/horse selection, dismount cleanup, bounded indoor searches, intent handover and human recruitment/cooldowns. The native server verifies startup and saved PvP flags; visual form transitions, animations, channel visibility and invitation UI require in-game acceptance. Ship boarding stands and transport routes are unchanged by this task.