CrowdBot

Uit 3Dwiki

De CrowdBot laat avatars rondlopen (of vliegen) in je wereld zodat het levendig wordt en je niet eenzaam bent als er verder geen andere bezoekers zijn. De Crowdbot registreert de bewegingen van een avatar om ze later af te kunnen spelen. Verder zijn een paar speciale eigenschappen zoals het bewegen van een auto die stopt voor voetgangers en het opnemen van de chat van de avatars.

De bot bestaat eigenlijk uit 2 bots, een voor het opnemen (record) en een andere voor het afspelen (playback). Je kunt ze los van elkaar maar ook tegelijkertijd draaien. De twee belangrijkste acties die je gebruikt zijn het opnemen en afspelen. Deze worden hieronder uitgelegd. Verderop staan alle commando's.

Inhoud 1 Opnemen 2 Afspelen 2.1 Individueel afspelen 2.2 Alles afspelen 2.3 Tijdens het afspelen 3 Commands 4 Opname bestanden 5 Configuratiebestand

[bewerken] Opnemen

Om op te nemen gebruik je /record:visitorname(,filename) waarbij visitorname de naam is van de gene die opgenomen wordt en filename de bestandsnaam van de opname. Als je geen bestandsnaam opgeeft wordt de visitorname daarvoor gebruikt.

Alle bewegingen, avatar veranderingen en gestures worden dan geregistreerd. Ook wordt er gekeken naar binnenkomst en het verlaten van de wereld. Dit is handig om te voorkomen dat de playback te lang stil staat aan het begin of einde; de opname begint op het moment dat je binnenkomt en stopt als je weggaat. Als het is ingesteld wordt ook de chat van de persoon opgenomen.

Als je klaar bent gebruik je /endrecord om de opname te stoppen.

Tijdens het opnemen is het handig om de avatar bijwerkingen per seconde van de wereld in te stellen op 4/5. Anders is de playback erg statisch. Vergeet het niet weer terug te zetten, het zorgt voor extra bandbreedte :)

[bewerken] Afspelen

Als je net een opname hebt gemaakt en wilt kijken of ie gelukt is kun je het beste individueel afspelen. Als je gewoon alle opnames uit de 'playlist' wil afspelen moet je alles afspelen.

Er zijn een aantal standaard instellingen bij een opname die je kunt aanpassen in het opnamebestand.

• Het afspelen zal zich voor elke bot steeds herhalen.
• De naam en avatar van de opgenomen persoon wordt gebruikt voor de bot.
• De bot zal standaard niet als auto reageren.

[bewerken] Individueel afspelen

Het afspelen gaat met het /reload:(botnum) (movement file) command. Als botname kun je als het goed is een willekeurig nummer van 1 t/m 32 gebruiken, maar 1 is het meest logisch :) Als movementfile moet je het bestand opgeven van je opname. Als je daarnet /record:john hebt gedaan, is het bestand opgeslagen als john.ini.

Als je tevreden bent met je opname kun je het opslaan in de 'playlist' om het te kunnen afspelen met de andere opnames. Gebruik hiervoor /save:botnum,movementfile. Als botnum kun je een nummer kiezen van 1 t/m 32. De movementfile is de naam van het opname bestand.

[bewerken] Alles afspelen

Vóór het afspelen moet je een opname opslaan in de 'playlist', zie individueel afspelen hierboven.

Het afspelen van alle opnames uit de playlist doe je met het /reload:(botnum) (movement file) command. Je kunt beide argumenten (botnum en movement file) leeglaten, als botnum kun je ook een 0 typen. Dus /reload:0.

Als je wilt afspelen zonder verder op te nemen (wereld is gewoon in gebruik) zet de record/control-bot dan niet aan.

[bewerken] Tijdens het afspelen

Tijdens het afspelen kun je de bot:

• tijdelijk stoppen met /suspend(:elevation).
• weer doorgaan met /resume.
• helemaal stoppen met /stop:botnumber.

[bewerken] Commands

Voor alle commands moet je 'boss' van de bot zijn, dit wordt ingesteld in het configuratiebestand. De commands kun je invoeren via de chat. Hiervoor moet de control bot wel gestart worden. De playback bot reageert niet op commands. Als de bot reacgeert in de chat op een command zie alleen jij die reactie. Specifiekere uitleg staat op de officiele helppagina.

In de windows versie kun je sommige acties ook uitvoeren in de GUI.

/crowdhelp

Geeft in de chat de commands en een korte beschrijving weer.

/reload:(botnum) (movement file)

Speelt opnames af, je kunt 1 opname afspelen of alle opnames in de 'playlist'. Om 1 opname af te spelen gebruik je als botnum een nummer van 1 t/m 32 gebruiken, maar 1 is het meest logisch :) Als movementfile moet je het bestand opgeven van je opname, bijvoorbeeld /reload:1 john.ini. Als je alle opnames uit de playlist wil afspelen kun je beide argumenten (botnum en movement file) leeglaten, als botnum kun je ook een 0 typen. Dus /reload:0.

/record:visitorname(,filename)

Waarbij visitorname de naam is van de gene die opgenomen wordt en filename de bestandsnaam van de opname. Als je geen bestandsnaam opgeeft wordt de visitorname daarvoor gebruikt. Als je een echte visitor (en dus geen citizen) wilt opnemen moet je de "" wel typen, ze zullen niet worden gebruikt in de opname of de filename.

/talkrecord:visitorname(,filename)

Hetzelfde als /record alleen wordt ook de chat opgenomen. De chat bij de opname kan bij het afspelen alsnog worden in- of uitgeschakeld.

/endrecord

De opname wordt gestopt.

/suspend(:elevation)

De playback wordt gepauzeerd. Als je de elevation niet meegeeft worden de bots naar een bepaalde hoogte verplaatst de standaard waarde staat in het configuratiebestand. Als je de elevation wel meegeeft worden ze naar die hoogte (of 'laagte') gestuurd en wordt de waarde in het configuratiebestand aangepast.

/resume

De playback zal na een pauze (/suspend) worden hervat.

/speedset:botnumber,speeddivisor

Hiermee kun je het afspelen vertragen of versnellen. De botnumber is het nummer van de bot (goh), van 1 t/m 32. De speeddevisor moet een float (kommagetal) zijn. Twee keer zo langzaam is 2.0, twee keer zo snel is 0.5.

/number:numberofcrowd

Het maximaal aantal bots wat tegelijk afgespeeld wordt met een /reload:0 of als de crowdbot automatisch start.

/save:botnum,movementfile

Om een opname op te slaan in de 'playlist'. Als botnum kun je een nummer kiezen van 1 t/m 32. De movementfile is de naam van het opname bestand.

/stop:botnumber

Om de playback te stoppen en de bots echt te verwijderen. Het botnumber is het nummer van 1 t/m 32. Als je 0 gebruikt stoppen alle bots.

/talk:botnumber

Zet het praten tijdens de playback aan of uit, de chat moest wel ingeschakeld zijn tijdens het opnemen. Het botnumber is het nummer van 1 t/m 32. Als je 0 gebruikt praten alle bots wel of niet.

/cars

Zet het auto-gedrag tijdens de playback aan of uit, in het opnamebestand van een bot moet wel staan dat het een auto is. Tijdens de playback zal dan worden gestopt voor voorbijgangers. Na 15 seconde zal de avatar/auto toch doorrijden.

/honk

Zet het toeter-gedrag van de auto's aan of uit. Het toetergedrag wordt geuit in de chat, met "beep... beep... beep..." na 5 seconde en "HONK!! HONK!! HONK!!" na 10 seconde :)

/details

Zet gedetailleerde log aan of uit, handig voor debuggen.

[bewerken] Opname bestanden

De opname van een avatar wordt opgeslagen in een configuratiebestand. Hieronder staat de uitleg van dit bestand, zodat je het ook handmatig kunt aanpassen. Let op: alle waardes in het opnamebestand zijn in centimeters, 0.1 graden of 100 milliseconde.

Naam

De naam van de bot staat op de tweede regel. Hier kun je ook instellen of tijdens het afspelen het auto-gedrag gebruikt moet worden (standaard uit) en of het afspelen zich herhaalt (standaard aan). Voorbeelden:

• # for:John
• # car for:audi3
• # noloop for:SpaceWalker
• # noloop car for:Ambulance

Als bots niet herhaald worden kunnen ze handmatig gestart worden via het /reload command.

Standaard waardes / offsets

Hier kun je voor elke stap van de playback een standaard waarde / offset instellen. Het GESTURE nummer wordt niet gebruikt, alleen om de regel te laten kloppen met de opname regels.

• +Xoffset Yoffset Zoffset YAWoffset PITCHoffset AVATAR GESTURE DURATIONoffset DURATIONmultiplier =
• +0 300 0 0 0 5 0 0 1 =

Bij het voorbeeld krijgt de hoogte van de avatar (Yoffset) een begin van 3 meter. Er wordt standaard avatar nummer 5 gebruikt. En de DURATIONmultiplier staat op 1, alle tijden worden met 1 vermenigvuldigd, standaard dus.

Opname

Elke beweging wordt opgeslagen op een aparte regel:

• X Y Z YAW PITCH AVATAR GESTURE DURATION ACTION = [Optional chat string]

De meeste waardes spreken voor zich, alleen de ACTION heeft uitleg nodig:

• action=-2: de avatar vertrekt uit de wereld
• action=-1: de avatar komt de wereld binnen
• action=256: de avatar praat, de tekst wordt opgeslagen na het = teken
• action=257: voor debuggen, er wordt een punt aangemaakt in de log

Verder nog een opmerking over de DURATION, deze gaat per 100 milliseconde, 4 staat dus voor 400 milliseconde. Standaard staat het maximum op 6000 (10 minuten), dit kan worden ingesteld in het configuratiebestand. Een lagere waarde zorgt voor een hoger bandbreedte gebruik terwijl gebruikers het niet zullen zien! Zet de waarde op de helft van de avatar bijwerkingen per seconde van de wereld. Als de avatar bijwerkingen per seconde op 1 staat (standaard) gebruik dan dus een Duration van 4/5 (= 400/500 milliseconde).

Nog een voorbeeld. De avatar wordt verplaatst naar 15.353N 7.307E 1.11a 162, met avatarnummer 5, zonder gesture uit te voeren en blijft daar voor 10 seconde:

• 7307 1110 15353 -1621 0 5 0 100 0 =

[bewerken] Configuratiebestand

Er wordt van alles opgeslagen in het configuratiebestand, standaard crowd.ini. Er zijn echter maar een paar waardes interessant voor semi-dagelijks gebruik. Uitleg van alle instellingen staat ook op de officiele helppagina.

AutoStartCrowd=0

De playback-bot zal worden gestart, alle movementfiles in de playlist zullen worden automatisch afgespeeld.

AutoStartBot=0

De record/control-bot zal worden gestart, zonder deze kun je de bot niet commanderen of opnames maken. Maar als alleen de playback wordt gebruikt kan ie beter uit staan.

CarsEnabled=0

Of auto-gedrag standaard aan staat of niet.

HonkEnabled=0

Of toeter-gedrag van de auto's standaard aan staat of niet.

Visible=0

Of de bot zichtbaar is in de wereld. Als de bot zichtbaar is kan je commands via whisper doorgeven en hoeft het niet in de chat.

CrowdNumber=4

Het maximaal aantal bots wat tegelijk afgespeeld wordt met een /reload:0 of als de crowdbot automatisch start.

SuspendElevation=3000

De hoogte (of 'laagte') waar de bots heen worden verplaatst bij pauzeren (/suspend).

MaxDuration=6000

Maximale tijd van één playback.

CrowdName1=Crowd

De naam van de eerste bot. Aangezien deze wordt overschreven door de naam in het opnamebestand is deze waarde eigenlijk nutteloos.

MoveFile1=botmove1.ini

De bestandsnaam van het opnamebestand van de eerste bot.

Boss0=1

De eigenaren van de bot, deze kunnen de commands gebruiken.

Je kunt meerdere playback bots maken door het nummer bij CrowdName1 en MoveFile1 aan te passen, het gaat van 1 t/m 32. Om meerdere eigenaren te maken pas je het nummer in Boss0 aan, dit gaat van 0 t/m 99. Waarschijnlijk moet de Boss0 gelijk staan aan de persoon onder wie de bot inlogt.