Add profile-driven AdventureBot character generation
clang PCH / build (push) Waiting to run
GCC PCH / build (push) Canceled after 0s

This commit is contained in:
Nico committed 2026-10-28 11:30:47 +01:00
1 parent e333f2f9fc
commit 04aa87fcfc
33 files changed
+3465 -2

No files matched your search

+76
View File
@@ -1,3 +1,79 @@
# Aktuell: Automatische AdventureBot-Erzeugung abgeschlossen
Stand28.10.2026 auf feature/clientless-player-core. Nutzer beauftragte einen
Generator für neue Bots mit RP-Namen/Profilen, passenden Fähigkeiten, Berufen
und Ausrüstung; Kennzeichnung für spätere temporäre Rotation. Nutzer hat den
lokalen Commit beauftragt; kein Push. SQL-Migration2026_10_28_00_adventure_generator.sql
wegen SQL-Ignore bereits gezielt vorgemerkt; Test-Charakter-DB zweimal angewendet.
ClientlessCharacterFactory ist generische native Infrastruktur ohne Adventure-
Abhängigkeit: Player::Create, validierte zufällige Optik, Geburt auf Zielstufe
via native Initialisierung statt GiveLevel-Belohnungen, Vorbereitungscallback,
gemeinsamer Save+Profil+Homebind+Ownership-Commit; Cache/Hook erst nach Erfolg.
Neue AdventureGeneratorMgr/Policy: zehn native legale Klassen-Archetypen,
zwölf Völker, kulturelle Namensgrammatiken, Herkunft/Beruf/Personalityprofile.
Profile liegen in Character-DB und werden als generated:<guid> im vorhandenen
Lua-Sandboxparser geladen. Handgeschriebene Namensprofile haben Vorrang und ihre
Namen werden bei Erzeugung reserviert. Keine Laufzeitdateien im Profilquellbaum.
Wichtige Live-Fixes: Berufs-Lernzauber mit Effekt44 wirken vor Welteintritt
nicht zuverlässig. Native SkillRaceClass/SkillTiers + Player::SetSkill bereiten
legale volle Ränge vor; Hilfsfunktion verweigert Online-Spieler. Online-
Selbstversorgung unverändert. Rollen-Ausrüstung prüft native Equipregeln,
Werte, temporäre/reputations-/gebietsgebundene Items, Mana-/Zauber-/physische
Effekte und keine doppelten ausgerüsteten Einträge. Ersetzte Items bleiben in
Taschen. Native Trainer::CanTeachSpell lediglich read-only öffentlich gemacht.
Arms nutzt vorhandenen Talentplan, andere Klassen gültigen Tier-Basisplan.
Befehle: clientless generate create <account> <count> [level faction archetype
persistent|temporary seed]; optionale fünf Parameter nur gemeinsam. Kurzform
level60, any/any, persistent. Count1..10, level10..85, DK>=55, Account normal
und ohne Netzwerksitzung, normale Realm-Charaktergrenze. Beispiel für Tests:
clientless generate create 6 1 60 alliance warrior temporary 42.
list/profile/login/logout/equip/retire <guid>. Erzeugung offline; login explizit.
equip nur eigener online/lebender/ruhiger Bot, native Checks, alte Items behalten.
retire nur eigener offline-temporärer Bot, markiert nur Metadaten, keine Löschung.
Automatische Rotation, Löschung, Accountanlage und Populationssteuerung später.
Vollständige Doku: doc/clientless/generator.md.
Debug-j10 erfolgreich installiert,62/62 Tests bestanden. Testserver88947 läuft,
frische Ready + Port8085 verifiziert. Vier neue Stufe60-Bots online und mit
individuellen DB-Profilen nach Neustart/Relog wieder geladen:
-29 Aelion, Nachtelf-Krieger, Teldrassil/poi_guard_111.
-30 Zanzan, Troll-Krieger, Durotar/poi_tele_823.
-31 Lenara, Worgen-Magierin, Elwynn/poi_npc_280710.
-32 Aldren, Untoter-Todesritter, Silberwald/poi_npc_321922.
Native Talentbäume746/746/851/400, Talentzeilen13/13/14/12,
Zauberanzahl80/80/87/64. Alle vier Nebenberufe und vier22er-Glutseidenstofftaschen,
alle fünf Vorratsstacks20. Primär: Krieger/DK Mining450+Smith375; Magierin
Tailoring375+Enchant375. Werte stammen aus gegenwärtigen nativen Trainerdaten.
Ausrüstungsauffrischung29..32 nativ erfolgreich gespeichert, alte Items behalten.
NPC-Szenen und lokale soziale Intents laufen; keine visuelle Abnahme behauptet.
Eigene frühere Testcharaktere27 Dagri und28 Jarana sind retired/offline, mit
vollständig erhaltenen Daten. Retire26 verweigert (kein generierter Besitz),
Login27 verweigert (retired). Inventarzuordnungen/Entries für21 und26 gegenüber
vorher bytegleich (Hash im Checkpoint). Arthoran wurde für Wartung sauber
abgemeldet und bleibt OFFLINE; keine Profiloverrides, keine Teleportierung.
Bestehende Sourceprofile unverändert. Account6 enthält nun7 Charaktere, normale
Realmgrenze beachten; archivierte Charaktere belegen weiterhin Plätze.
Ein erster Start traf bekannten temporären Auth-DB-Ausfall10.0.0.1. Nicht
reagierender Fehlstart76094 perSIGTERM beendet, zweiter Versuch erfolgreich;
keine VPS-/Produktionskonfiguration geändert. Spätere Starts erfolgreich.
Für alle neuen Klassen gilt weiter: bekannte Fähigkeiten sind keine fertige
Klassen-Kampfrotation; außer Krieger bisher grundlegender Autoangriff. Rollen,
Bot-Gruppenbildung, PvP-Erstangriffe und Rotation bleiben spätere Aufgaben.
Belege: doc/clientless/checkpoints/2026-10-28-generator/. Aktuelle Logs
/tmp/vcore-generator-{build-refit,install-refit}.log; DB-Helfer
/tmp/vcore-generator-db.py audit/details/compare (keine Zugangsdaten ausgeben).
Nutzer hat alle CMake- und tmux-Befehle sowie git add/commit auf diesem Branch
ausdrücklich dauerhaft autorisiert. Keine erneuten inhaltlichen Rückfragen;
technische Sandboxregeln bleiben maßgeblich. Kein Push ohne ausdrücklichen Auftrag.
---
# Aktuell: Interaktionen und spielergeführte Gruppen umgesetzt
Stand 28.10.2026. Nutzer beauftragte Umsetzung nach gemeinsamer Planung.
@@ -0,0 +1,4 @@
[1/4] cd /home/wow_admin/wow_cata_server/source/TrinityCore && /usr/bin/cmake -DBUILDDIR="/home/wow_admin/wow_cata_server/build/debug" -P /home/wow_admin/wow_cata_server/source/TrinityCore/cmake/genrev.cmake /home/wow_admin/wow_cata_server/build/debug
[2/4] Building CXX object src/server/game/CMakeFiles/game.dir/World/AdventureGeneratorMgr.cpp.o
[3/4] Linking CXX static library src/server/game/libgame.a
[4/4] Linking CXX executable src/server/worldserver/worldserver
@@ -0,0 +1 @@
Production equipment affinity: mana-only/direct/triggered procs, caster/physical stat effects and bounded cycles passed
@@ -0,0 +1 @@
Production native factory: character/profile atomicity, failed preparation/commit, cache publication order, account/security/name/cap gates passed
@@ -0,0 +1,30 @@
from pathlib import Path
import os,re,subprocess,sys
root=Path('/home/wow_admin/wow_cata_server/source/TrinityCore')
conf=Path('/home/wow_admin/wow_cata_server/server/debug/etc/worldserver.conf').read_text()
def query(kind,sql):
h,port,u,p,db=re.search(r'^'+kind+r'DatabaseInfo\s*=\s*"([^"]+)"',conf,re.M).group(1).split(';')
env=os.environ.copy();env['MYSQL_PWD']=p
r=subprocess.run(['mysql','--protocol=TCP','--host='+h,'--port='+port,'--user='+u,'--database='+db,'--batch','--connect-timeout=10'],input=sql,text=True,capture_output=True,env=env)
if r.returncode:raise SystemExit(r.stderr.replace(p,'[redacted]'))
return r.stdout
mode=sys.argv[1]
if mode=='inspect':
print(query('World',"SHOW COLUMNS FROM trainer; SHOW COLUMNS FROM trainer_spell; SHOW COLUMNS FROM vcore_clientless_world_point; SELECT l.point_key,l.display_name,l.faction,w.map,w.position_x,w.position_y,w.position_z,w.category FROM vcore_adventure_location l JOIN vcore_clientless_world_point w ON w.point_key=l.point_key WHERE w.enabled=1 AND w.category='city' ORDER BY l.point_key LIMIT 25;"))
print(query('Character','SELECT account,COUNT(*) AS characters FROM characters WHERE account=6 GROUP BY account;'))
elif mode=='migrate':
print(query('Character',(root/'sql/custom/characters/2026_10_28_00_adventure_generator.sql').read_text()))
elif mode=='baseline':
import hashlib
text=query('Character',"SELECT ci.guid,ci.bag,ci.slot,ci.item,i.itemEntry FROM character_inventory ci JOIN item_instance i ON i.guid=ci.item WHERE ci.guid IN (21,26) ORDER BY ci.guid,ci.bag,ci.slot,ci.item;")
Path('/tmp/vcore-generator-existing-items.tsv').write_text(text)
print('Existing item ownership baseline',hashlib.sha256(text.encode()).hexdigest())
elif mode=='compare':
import hashlib
text=query('Character',"SELECT ci.guid,ci.bag,ci.slot,ci.item,i.itemEntry FROM character_inventory ci JOIN item_instance i ON i.guid=ci.item WHERE ci.guid IN (21,26) ORDER BY ci.guid,ci.bag,ci.slot,ci.item;")
print('Existing item ownership unchanged:',text==Path('/tmp/vcore-generator-existing-items.tsv').read_text(),hashlib.sha256(text.encode()).hexdigest())
elif mode=='details':
print(query('Character',"SELECT c.guid,c.name,c.level,c.talentTree,c.map,c.instance_id,c.position_x,c.position_y,c.position_z,c.health,c.power1,g.state,g.persistent FROM characters c JOIN vcore_adventure_generated_bot g ON g.character_guid=c.guid ORDER BY c.guid; SELECT ci.guid,ci.slot,i.itemEntry FROM character_inventory ci JOIN item_instance i ON i.guid=ci.item JOIN vcore_adventure_generated_bot g ON g.character_guid=ci.guid WHERE g.state='ready' AND ci.bag=0 AND ci.slot IN (12,13) ORDER BY ci.guid,ci.slot; SELECT ci.guid,i.itemEntry,SUM(i.count) AS count FROM character_inventory ci JOIN item_instance i ON i.guid=ci.item JOIN vcore_adventure_generated_bot g ON g.character_guid=ci.guid WHERE g.state='ready' AND i.itemEntry IN (21991,22829,22832,27854,28399) GROUP BY ci.guid,i.itemEntry ORDER BY ci.guid,i.itemEntry; SELECT g.character_guid,LENGTH(g.profile_lua) AS profile_bytes,c.name,CONCAT('identity name matches: ',g.profile_lua LIKE CONCAT('%name = ',CHAR(34),c.name,CHAR(34),'%')) AS identity_check FROM vcore_adventure_generated_bot g JOIN characters c ON c.guid=g.character_guid WHERE g.state='ready' ORDER BY g.character_guid;"))
elif mode=='audit':
print(query('Character',"SELECT g.character_guid,c.name,c.race,c.class,c.gender,c.level,c.online,g.archetype,g.persistent,g.state,g.seed,c.health FROM vcore_adventure_generated_bot g JOIN characters c ON c.guid=g.character_guid ORDER BY g.character_guid; SELECT ci.guid,ci.slot,i.itemEntry,i.durability FROM character_inventory ci JOIN item_instance i ON i.guid=ci.item JOIN vcore_adventure_generated_bot g ON g.character_guid=ci.guid WHERE ci.bag=0 AND ci.slot<23 ORDER BY ci.guid,ci.slot; SELECT s.guid,s.skill,s.value,s.max FROM character_skills s JOIN vcore_adventure_generated_bot g ON g.character_guid=s.guid WHERE s.skill IN (129,185,356,794,164,186,182,171,197,333,165,393) ORDER BY s.guid,s.skill; SELECT t.guid,COUNT(*) AS talent_spells FROM character_talent t JOIN vcore_adventure_generated_bot g ON g.character_guid=t.guid GROUP BY t.guid; SELECT s.guid,COUNT(*) AS spells FROM character_spell s JOIN vcore_adventure_generated_bot g ON g.character_guid=s.guid GROUP BY s.guid;"))
else:raise SystemExit('Unknown mode')
@@ -0,0 +1,27 @@
TrinityCore rev. e333f2f9fc8b+ 2026-10-28 01:11:54 +0100 (feature/clientless-pla
yer-core branch) (Unix, Debug, Static) (worldserver-daemon)
<Ctrl-C> to stop.
______ __
/\__ _\ __ __/\ \__
\/_/\ \/ _ __ /\_\ ___ /\_\ \, _\ __ __
\ \ \/\`'__\/\ \ /' _ `\/\ \ \ \/ /\ \/\ \
\ \ \ \ \/ \ \ \/\ \/\ \ \ \ \ \_\ \ \_\ \
\ \_\ \_\ \ \_\ \_\ \_\ \_\ \__\\/`____ \
\/_/\/_/ \/_/\/_/\/_/\/_/\/__/ `/___/> \
C O R E /\___/
http://TrinityCore.org \/__/
Using configuration file /home/wow_admin/wow_cata_server/server/debug/etc/worlds
erver.conf.
Using SSL version: OpenSSL 3.5.5 27 Jan 2026 (library: OpenSSL 3.5.5 27 Jan 2026
)
Using Boost version: 1.90.0
Automatic database updates are disabled for all databases!
Could not connect to MySQL database at 10.0.0.1: Can't connect to server on '10.
0.0.1' (115)
DatabasePool Login NOT opened. There were errors opening the MySQL connections.
Check your SQLDriverLogFile for specific errors. Read wiki at http://www.trinity
core.info/display/tc/TrinityCore+Home
server shutdown 0
@@ -0,0 +1,176 @@
character_guid name race class gender level online archetype persistent state seed health
27 Dagri 3 1 1 60 0 warrior 0 retired 20261028 5049
28 Jarana 8 1 1 60 0 warrior 0 retired 20261029 5309
29 Aelion 4 1 0 60 1 warrior 0 ready 20261101 5189
30 Zanzan 8 1 0 60 1 warrior 0 ready 20261102 5409
31 Lenara 22 8 1 60 1 mage 0 ready 20261103 3600
32 Aldren 5 6 0 60 1 death_knight 0 ready 20261104 5259
guid slot itemEntry durability
27 0 23314 80
27 1 24073 0
27 2 21805 80
27 4 23300 135
27 5 22197 45
27 6 13498 100
27 7 31125 65
27 8 18754 45
27 9 22714 45
27 10 19873 0
27 11 24151 0
27 12 19930 0
27 13 19930 0
27 14 34659 0
27 15 31134 100
27 19 54443 0
27 20 54443 0
27 21 54443 0
27 22 54443 0
28 0 23244 80
28 1 24073 0
28 2 77868 80
28 4 22872 135
28 5 22197 45
28 6 21495 100
28 7 31125 65
28 8 22205 45
28 9 22868 45
28 10 27832 0
28 11 24151 0
28 12 19930 0
28 13 19930 0
28 14 22337 0
28 15 24044 100
28 17 25861 25
28 19 54443 0
28 20 54443 0
28 21 54443 0
28 22 54443 0
29 0 77867 80
29 1 24073 0
29 2 23315 80
29 4 77858 135
29 5 21503 45
29 6 13498 100
29 7 24064 65
29 8 12936 45
29 9 22714 45
29 10 27834 0
29 11 21477 0
29 12 13213 0
29 13 22321 0
29 14 34659 0
29 15 31134 100
29 19 54443 0
29 20 54443 0
29 21 54443 0
29 22 54443 0
30 0 23244 80
30 1 24073 0
30 2 23243 80
30 4 34650 115
30 5 19051 45
30 6 21475 100
30 7 24064 65
30 8 77861 45
30 9 22868 45
30 10 12058 0
30 11 24151 0
30 12 20072 0
30 13 11810 0
30 14 22337 0
30 15 31134 100
30 17 25861 25
30 19 54443 0
30 20 54443 0
30 21 54443 0
30 22 54443 0
31 0 22720 80
31 1 23125 0
31 2 21468 80
31 4 16700 135
31 5 16696 45
31 6 19683 100
31 7 21489 65
31 8 13107 45
31 9 16391 45
31 10 24045 0
31 11 19905 0
31 12 11819 0
31 13 21473 0
31 14 21470 0
31 15 20654 100
31 17 21801 65
31 19 54443 0
31 20 54443 0
31 21 54443 0
31 22 54443 0
32 0 22223 80
32 1 24073 0
32 2 21805 80
32 4 10845 135
32 5 21503 45
32 6 21475 100
32 7 24064 65
32 8 12936 45
32 9 22714 45
32 10 11934 0
32 11 19510 0
32 12 13164 0
32 13 1973 0
32 14 22337 0
32 15 31134 100
32 19 54443 0
32 20 54443 0
32 21 54443 0
32 22 54443 0
guid skill value max
27 129 375 375
27 164 375 375
27 185 525 525
27 186 450 450
27 356 525 525
27 794 375 375
28 129 375 375
28 164 375 375
28 185 525 525
28 186 450 450
28 356 525 525
28 794 375 375
29 129 375 375
29 164 375 375
29 185 525 525
29 186 450 450
29 356 525 525
29 794 375 375
30 129 375 375
30 164 375 375
30 185 525 525
30 186 450 450
30 356 525 525
30 794 375 375
31 129 375 375
31 185 525 525
31 197 375 375
31 333 375 375
31 356 525 525
31 794 375 375
32 129 375 375
32 164 375 375
32 185 525 525
32 186 450 450
32 356 525 525
32 794 375 375
guid talent_spells
27 13
28 13
29 13
30 13
31 14
32 12
guid spells
27 80
28 80
29 80
30 80
31 87
32 64
@@ -0,0 +1,42 @@
guid name level talentTree map instance_id position_x position_y position_z health power1 state persistent
27 Dagri 60 746 0 0 0 -5385.04 310.278 394.151 5049 0 retired 0
28 Jarana 60 746 0 1 0 -813.097 -4880.08 18.995 5309 0 retired 0
29 Aelion 60 746 0 1 0 9808.68 969.19 1309.75 5189 0 ready 0
30 Zanzan 60 746 0 1 0 -826.364 -4879.64 19.5037 5409 0 ready 0
31 Lenara 60 851 0 0 0 -9470.25 25.9936 56.3394 3600 6813 ready 0
32 Aldren 60 400 0 0 0 1095.38 1587.06 28.5303 5259 0 ready 0
guid slot itemEntry
29 12 13213
29 13 22321
30 12 20072
30 13 11810
31 12 11819
31 13 21473
32 12 13164
32 13 1973
guid itemEntry count
29 21991 20
29 22829 20
29 22832 20
29 27854 20
29 28399 20
30 21991 20
30 22829 20
30 22832 20
30 27854 20
30 28399 20
31 21991 20
31 22829 20
31 22832 20
31 27854 20
31 28399 20
32 21991 20
32 22829 20
32 22832 20
32 27854 20
32 28399 20
character_guid profile_bytes name identity_check
29 873 Aelion identity name matches: 1
30 870 Zanzan identity name matches: 1
31 858 Lenara identity name matches: 1
32 886 Aldren identity name matches: 1
@@ -0,0 +1 @@
Production generator commands: batch bounds, dedicated ownership, persistent/online/removing retirement protection and retired login refusal passed
@@ -0,0 +1 @@
Production generator: 6144 cultural names and 61440 real Lua profiles, profession coherence, personality ranges, escaping and equipment/armor gates passed
@@ -0,0 +1 @@
Production offline skill preparation: native tier caps, no downgrading, rank/level/race/tier gates and no modification of online players passed
File diff suppressed because it is too large. Load diff
@@ -0,0 +1,63 @@
test_adventure_area_node.py: PASS
test_adventure_behavior_policy.py: PASS
test_adventure_combat_exercise.py: PASS
test_adventure_combat_preparation.py: PASS
test_adventure_combat_reactions.py: PASS
test_adventure_economy.py: PASS
test_adventure_economy_catalog.py: PASS
test_adventure_exploration.py: PASS
test_adventure_exploration_catalog.py: PASS
test_adventure_generator_equipment.py: PASS
test_adventure_generator_ownership.py: PASS
test_adventure_generator_policy.py: PASS
test_adventure_graph_handover.py: PASS
test_adventure_instance.py: PASS
test_adventure_instance_autoresume.py: PASS
test_adventure_instance_begin.py: PASS
test_adventure_instance_catalog.py: PASS
test_adventure_instance_persistence.py: PASS
test_adventure_intent_state.py: PASS
test_adventure_interactions.py: PASS
test_adventure_leisure.py: PASS
test_adventure_leisure_catalog.py: PASS
test_adventure_location_import.py: PASS
test_adventure_micro_reset.py: PASS
test_adventure_profession_catalog.py: PASS
test_adventure_profession_profile.py: PASS
test_adventure_profession_sightline.py: PASS
test_adventure_profession_targets.py: PASS
test_adventure_repair_catalog.py: PASS
test_adventure_rest.py: PASS
test_adventure_rest_fire.py: PASS
test_adventure_rest_space.py: PASS
test_adventure_rest_targets.py: PASS
test_adventure_social.py: PASS
test_adventure_social_fire.py: PASS
test_adventure_supplies.py: PASS
test_adventure_supply_catalog.py: PASS
test_adventure_supply_items.py: PASS
test_adventure_training_catalog.py: PASS
test_adventure_walk.py: PASS
test_clientless_character_factory.py: PASS
test_clientless_companion.py: PASS
test_clientless_damage_notifications.py: PASS
test_clientless_near_teleport_observer.py: PASS
test_clientless_skill_preparation.py: PASS
test_clientless_social_notifications.py: PASS
test_default_phase.py: PASS
test_flight_area_query.py: PASS
test_flight_handoff.py: PASS
test_flight_policy.py: PASS
test_follow_spline_velocity.py: PASS
test_free_flight.py: PASS
test_free_flight_planner.py: PASS
test_ground_exit_continuation.py: PASS
test_local_spline_segments.py: PASS
test_lua_reload.py: PASS
test_player_pure_max_skill.py: PASS
test_portal_transfer.py: PASS
test_portal_use.py: PASS
test_taxi_import_disabled.py: PASS
test_transport.py: PASS
test_transport_grid_loading.py: PASS
62/62 passed; failures: []
@@ -0,0 +1,17 @@
Generator implemented on feature/clientless-player-core, local commit requested by user; no push.
Final Debug-j10 build and installation succeeded. Native test worldserver88947 freshly ready, port8085 verified.
62/62 test scripts passed.
Character migration applied twice successfully (additive/idempotent).
Initial offline profession preparation failed without saving a partial character; fixed with validated native DBC skill tier initialization before world insertion.
Generated four active temporary level60 characters:29 Aelion night elf warrior;30 Zanzan troll warrior;31 Lenara worgen mage;32 Aldren forsaken death knight.
Their profiles load as generated:29..32 after native logout/restart/login. All four online and running local social actions.
Native talent trees:746/746/851/400. Stored talent row counts13/13/14/12; spell counts80/80/87/64.
All four have FirstAid375, Cooking525, Fishing525, Archaeology375 using current native data. Warriors/DK:Mining450+Blacksmithing375. Mage:Tailoring375+Enchanting375.
All four have four22-slot Embersilk Bags and one full20-stack of each of the five supply roles.
Equipment affinity checks include stats, native legality, mana/physical/spell-only procs and duplicate avoidance. Native online equipment refresh29..32 saved; all replaced items retained.
Own earlier fixture characters27/28 were archived, not deleted. Their inventories/profiles retained.
Live generator retirement of Arthoran26 refused (not owned); generator login27 refused (retired).
Existing item ownership/entry/slot snapshot for21 and26 unchanged:sha256 dd5869ffb3f10aa7d25dfc93b8de61d0b982715ab27b28e7d6311f562a6d066c.
First server start in this task hit transient remote Login DB error10.0.0.1; failed process76094 did not respond to console and was terminated with SIGTERM. Second attempt succeeded. No remote DB configuration modified.
Arthoran was logged out for maintenance and remains offline. No temporary profile/source overrides were used. His source profile and Allitester's equipment were not changed.
Rotation/deletion/population targets/restart autologin are not enabled. Non-warrior combat/support AI limitations remain. Final visible gameplay acceptance is user-owned.
+151
View File
@@ -0,0 +1,151 @@
# AdventureBot generation
The GM/console command `clientless generate` creates complete new native player
characters on an existing normal bot account. No source player is cloned and no
authentication account/password is created or changed. The native realm-character
counter is updated for that account after a successful character commit.
## Commands
```
clientless generate create <account> <count>
clientless generate create <account> <count> <level> <faction> <archetype> <persistence> <seed>
clientless generate list
clientless generate profile <guid>
clientless generate login <guid>
clientless generate logout <guid>
clientless generate equip <guid>
clientless generate retire <guid>
```
The short create form defaults to level60, any faction/archetype, persistent,
and a time-based seed. When specifying options, supply all five optional values.
Count is1–10 per request, level10–85 (also limited by server maximum), faction is
`any`, `alliance` or `horde`, and persistence is `persistent` or `temporary`.
Each character is committed separately. A failed batch reports its actual
completed count and retains already completed characters.
Available archetypes: `warrior`, `paladin`, `hunter`, `rogue`, `priest`,
`death_knight` (minimum55), `shaman`, `mage`, `warlock`, `druid`, or `any`.
Native race/class data and account expansion restrictions determine eligible
combinations. Both factions can use the administrative bot-account pool; this
is not a normal client's character-creation request.
`equip` refreshes the equipment of an idle online generator-owned bot using its
stored archetype and seed. Native checks still apply, casting/combat/transit are
rejected, and replaced items remain in bags. It requires sufficient bag space;
an error can stop an online refresh partway through. The initial offline create
pipeline is the atomic operation.
Creation leaves bots offline. Explicit login uses the existing AdventureBot Lua
controller. Initially they perform a local social intent for one hour at their
home. Enable the existing daily planner with `clientless adventure schedule
<guid> on` when desired. Rotation and automatic population targeting are not
activated by this change.
## Identity and profile
Names use curated cultural syllable combinations for the supported races and
sexes. They contain no numbers, bot markers or numeric collision suffixes.
Native name validation, reserved-name checks, character cache/database checks,
and reservation of hand-written named Lua profiles apply. An exhausted pool
fails cleanly instead of manufacturing a non-roleplay name.
Profiles include a racial origin, vocation, background, two coherent primary
professions, personality values and regional/activity affinities. The stored
seed makes choices reproducible against unchanged catalogs and name availability.
Existing name collisions legitimately advance the random stream. Equipment
varies within a set of similar high-scoring legal options.
Generated Lua is stored in the character database, avoiding runtime writes to
source-controlled profile files. The ordinary sandbox/parser loads it with
source `generated:<guid>`. Existing hand-written named Lua profiles retain
precedence; ordinary non-generated characters keep the generic fallback.
`identity.background` and `identity.vocation` are also available in the parsed
profile. Generated strings are Lua-escaped, then escaped separately for SQL.
Home points come from enabled, faction-compatible social tavern/settlement
locations nearest the native racial starting region. Mature goblins and worgen
use mainland orc/human home regions, rather than phased introductory maps.
Death knights also choose racial mainland homes. Map relocation happens before
native talent calculation, so introductory map609 does not reduce their talent
budget. This is administrative creation, not a claim that these bots played or
completed introductory quests.
## Native preparation
`ClientlessCharacterFactory` is generic infrastructure with preparation and
transaction-extension callbacks. It has no AdventureBot policy dependency.
It uses native `Player::Create`, validated random appearance, level/skill setup,
new player/item GUID allocators and native `SaveToDB`. Requested levels are
initialized as birth state through native stat/talent/taxi/glyph initialization,
avoiding earned-level reward mails/hooks before the character transaction. Network-active accounts,
privileged accounts, unavailable names and the configured per-realm character
limit are rejected.
The AdventureBot layer supplies:
- Native class-trainer spells, using the same read-only `CanTeachSpell` predicate
as ordinary native teaching; weapon/armor proficiencies are race/class/level
checked. Owned weapon skills are raised to their native level cap.
- A solo damage specialization and valid talent allocation through native talent
prerequisites, tiers, ranks and primary-tree gates. Arms uses the existing
explicit build, other archetypes use a legal tier-ordered baseline. These
generic builds are not claimed to be optimized raid/PvP builds.
- Coherent primary profession pairs, trained to their legal native rank/cap;
all four available secondary professions through existing supply preparation.
Before world insertion, effect44 learning casts cannot be relied on to apply
their target effects. The factory therefore initializes validated skill ranks
with native SkillRaceClass/SkillTiers caps and `Player::SetSkill`. This helper
refuses online players; ordinary live supply learning keeps its native casts.
This does not teach every profession recipe or synthesize quest rewards.
- Four native Embersilk Bags and class/stat/level-matching equipment. Candidate
items are normal/uncommon/rare; native use/equip checks remain authoritative.
Armor transitions at40 are respected. Temporary, holiday, reputation-bound,
restricted-map/area and random-affix equipment is excluded. Caster/physical
stat affinity and mana-only/triggered utility effects are checked, so a
warrior does not receive a mana-restoration trinket. Identical equipped
entries are not duplicated, in addition to native unique-equipment checks. Initial items
are retained in bags rather than destroyed.
- Existing daily/post-combat supply restocking upon login. Consumables are native
items and continue to use the existing actual item/cooldown logic.
No mounts, pets or optimized class rotations are introduced here. Existing
non-warrior combat limitations remain. Being fully trained is distinct from
having class-specific automated combat/support AI.
## Persistence and future rotation
Apply `sql/custom/characters/2026_10_28_00_adventure_generator.sql` before using
commands. The additive migration is idempotent. Native character state, inventory,
professions, Lua profile, homebind and generated ownership are committed in one
character-database transaction. Cache publication and create hooks happen only
after confirmed success. Failure before/at commit does not publish a ready bot.
The registry explicitly records ownership, seed, archetype, creation time,
persistence and state. Existing characters such as Arthoran are not adopted.
Only offline temporary generator-owned characters may be retired. Retirement
marks metadata only; the native character, items and profile remain available
for audit. Generator login refuses retired entries. Persistent characters are
protected. There is no automatic deletion, replacement, new-account allocation
or restart autologin. A later rotating population controller must define those
policies and account/name capacity management explicitly.
## Verification
Production-code adapter tests cover factory transaction failure/publication,
account/name/security/character-cap gates, retirement ownership protections,
command bounds, cultural naming, real Lua profile execution, personality/skill
coherence, string escaping and equipment/armor eligibility.
Compilation and adapters do not establish visible in-game behavior. Live-created
character identities, gear, profession/talent/spell rows and login/profile
results are recorded in the task checkpoint after native server checks.
Live checkpoint (2026-10-28): four level60 characters are online: Aelion29
(night elf warrior), Zanzan30 (troll warrior), Lenara31 (worgen mage), Aldren32
(forsaken death knight). Their generated profiles were reloaded after a server
restart, and native equipment refresh was saved for all four. Earlier temporary
fixtures27/28 remain archived and offline. Existing inventory ownership for
Allitester21 and Arthoran26 matched the pre-generation snapshot. All62 clientless
test scripts passed. See checkpoints/2026-10-28-generator/ for native data/logs.