cactbot

GitHub Workflow Status (branch)GitHub release (laatste SemVer)

🌎

  1. Over
  2. Installeren
  3. Bouwen From Source
  4. UI Module Overview
  5. Troubleshooting
  6. Cactbot Customization
  7. Supported Languages

About

cactbot is een ACT overlay die raiding tools biedt voor Final Fantasy XIV. Dit project is een overlay-plugin voorngld’s OverlayPlugin, die zelf een plugin is voorAdvanced Combat Tracker.

cactbot biedt deze modules:

  • raidboss: ingebouwde tijdlijnen en triggers:

timeline screenshottriggers screenshot

  • oopsyraidsy: error and death reporting

oopsy screenshot

  • jobs: gecomprimeerde meters met buff en proc tracking

rdm jobs screenshot

  • eureka: Eureka NM tracking map

eureka screenshot

  • visser: Fishing cast time tracking

fisher screenshot

  • radar: hunt mob directions, puller notifications

radar screenshot

  • dps: extra functies voor dps-meters

xephero screenshot

Video voorbeelden

  • O4S raidboss + monk jobs
  • O3S spellblade callouts

Installeren

Onafhankelijkheden

Installeer .NET Framework versie 4.6.1 of hoger.

U moet DirectX 11 ingeschakeld hebben voor Final Fantasy XIV.

Installeer de 64-bit versie van Advanced Combat Tracker, als u dat nog niet gedaan hebt.

Installeer FFXIV ACT Plugin

Als u ACT net geïnstalleerd hebt, krijgt u een opstart wizard te zien. Om anders naar de opstart wizard te gaan, klikt u op Options en dan op Show Startup Wizard.

 Screenshot van de opstartwizard

In de opstartwizard selecteert u FFXIV Parsing Plugin en klikt u vervolgens op de knop Download/Enable Plugin.Hierdoor wordt %APPDATA%Advanced Combat Tracker\Plugins\FFXIV_ACT_Plugin.dll gedownload en geactiveerd in de lijst met plugins.

startup wizard download screenshot

Verder moet u parsing vanaf het netwerk inschakelen en ervoor zorgen dat ACT niet is gefirewalled.Zorg ervoor dat bij de instellingen voor de FFXIV-plugin de knop “Include HP for Triggers” is aangevinkt. Deze staat onder Plugins ->FFXIV Settings -> Options.

Alternatieve FFXIV Plugin Gidsen:

  • fflogs video gids
  • TomRichter gids

Installeer ngld OverlayPlugin

Als u nu het Plugins tabblad selecteert en naar de Plugin Listing gaat, zou uw lijst met plugins er ongeveer zo uit moeten zien:

blank plugin listing screenshot

Klik op Get Plugins om het installatieprogramma van de ACT-plugin te openen.

Selecteer Overlay Plugin en klik vervolgens op Download and Enable.

overlay-plugin-selectiescherm

Dit downloadt de ngld OverlayPlugin in%APPDATA%Advanced Combat Tracker\Plugins\OverlayPlugin en activeert OverlayPlugin.dll in de lijst met plugins.

Aantekening: u moet de ngld-versie vanOverlayPlugin gebruiken en niet de originele RainbowMage-versie of de vork van hibiyasleep.

Cactbot

Opnieuw, ga naar de Plugins tab en ga naar de Plugin Listing,en selecteer dan Get Plugins.

Selecteer Cactbot en klik dan op Download and Enable.

cactbot selectie screenshot

Dit zal de cactbot downloaden in%APPDATA%Advanced Combat Tracker\Plugins\cactbot-version\cactbot en CactbotOverlay.dll activeren in de lijst van plugins.

Opmerking: Door een verschil in hoe ACT archieven verwacht en hoe cactbot zijn zip-bestanden genereert, zal er een cactbot-0.15.2 map zijn die overeenkomt met de oorspronkelijke versie die u van cactbot hebt gedownload. Deze mapnaam doet er niet toe en is cosmetisch.

Controleer of uw plugins in de juiste volgorde staan. De volgorde moet zijn: FFXIV Plugin eerst, dan OverlayPlugin, dan cactbot.Als u de bovenstaande instructies heeft opgevolgd, zou het er als volgt uit moeten zien:

plugin volgorde

Tot slot, herstart ACT.

Overlaymodules toevoegen

Hier volgt een voorbeeld van hoe u de raidboss overlaymodule instelt.Het instellen van andere cactbot overlays werkt identiek.

  1. Open ACT.
  2. Zorg ervoor dat u ACT opnieuw hebt opgestart na het toevoegen van de cactbot plugin.
  3. Navigeer naar de Plugins tab van ACT en dan de OverlayPlugin.dll tab erbinnen.
  4. Klik op de knop “Nieuw” en kies vervolgens Cactbot Raidboss in de lijst met voorinstellingen.

    nieuwe overlay-plugin screenshot

  5. Op dit punt zou u een test-uI op het scherm moeten zien verschijnen.Cactbot biedt een standaard test UI, een grote rode rand en een blauwe achtergrond om te helpen bij het wijzigen van de grootte en het plaatsen van overlays op het scherm. Deze verdwijnen allemaal wanneer de overlay is vergrendeld in het configuratiescherm voor de overlay. U moet uw overlay altijd vergrendelen wanneer u klaar bent met het wijzigen van de grootte en het plaatsen ervan.

    raidboss-plugin ontgrendeld

  6. Typ een willekeurige naam in als de naam van deze overlay, bijv. raidbossy.
  7. Klik op de OK knop om deze als Overlay toe te voegen.Deze verschijnt nu in de lijst met overlays in het Plugins -> OverlayPlugin.dll tabblad.

  8. Sleep en resize de overlay naar de plaats waar u hem wilt hebben.

  9. In het General tabblad van de Raidboss overlay, klik op de Lock Overlay en Enable Clickthrough checkboxes.De testbalken, debug tekst, gestippelde rode rand, en gearceerde blauwe achtergrond zullen verdwijnen zodra de overlay is vergrendeld.

    raidboss plugin config

  10. Als je de raidboss plugin wilt testen, teleporteer je naar Summerford Farms en doe je een /countdown 5.

  11. Het toevoegen van andere cactbot overlays is een vergelijkbaar proces.Volg hetzelfde proces maar selecteer een andere cactbot preset.

Bouwen vanaf bron

Volg eerst alle bovenstaande stappen voor het installeren van cactbot.Om afhankelijkheden te installeren zijn er 2 methodes: per script en handmatig

Veranderlijkheden: Script Methode

  1. curl MOET geïnstalleerd zijn (dit wordt gebruikt om afhankelijkheden te downloaden)
  2. Uitvoeren van het ./util/fetch_deps.py script
  3. Volgende stappen om te bouwen

Verander afhankelijkheden: Handmatige methode

  1. Download het nieuwste Zip-bestand van https://github.com/EQAditu/AdvancedCombatTracker/releases/
  2. Uitpakken Advanced Combat Tracker.exe naar cactbot/plugin/ThirdParty/ACT/
  3. Download het nieuwste SDK Zip-bestand van https://github.com/ravahn/FFXIV_ACT_Plugin/ (zorg ervoor dat het bestand SDK in de naam zegt)
  4. Uitpakken SDK folder en FFXIV_ACT_Plugin.dll naar cactbot/plugin/ThirdParty/FFXIV_ACT/.
  5. Download het laatste Zip bestand van https://github.com/ngld/OverlayPlugin/releases/
  6. Uitpakken libs folder evenals de OverlayPlugin.dll naar cactbot/plugin/ThirdParty/OverlayPlugin/
  7. Volgende stappen om te bouwen

De map zou er ongeveer zo uit moeten zien (houd in gedachten dat bestanden kunnen veranderen met updates in de toekomst):

ThirdParty|- ACT| |- Advanced Combat Tracker.exe|- FFXIV_ACT| |- SDK| | |- FFXIV_ACT_Plugin.Common.dll| | |- FFXIV_ACT_Plugin.Config.dll| | |- FFXIV_ACT_Plugin.LogFile.dll| | |- FFXIV_ACT_Plugin.Memory.dll| | |- FFXIV_ACT_Plugin.Network.dll| | |- FFXIV_ACT_Plugin.Overlay.dll| | |- FFXIV_ACT_Plugin.Parse.dll| | |- FFXIV_ACT_Plugin.Resource.dll| |- FFXIV_ACT_Plugin.dll|- OverlayPlugin |- libs | |- HtmlRenderer.dll | |- Markdig.Signed.dll | |- Newtonsoft.Json.dll | |- OverlayPlugin.Common.dll | |- OverlayPlugin.Core.dll | |- OverlayPlugin.Updater.dll | |- SharpCompress.dll | |- System.ValueTuple.dll | |- websocket-sharp.dll |- OverlayPlugin.dll

Stappen om plugin te bouwen

  1. Open de oplossing in Visual Studio (getest met Visual Studio 2017).
  2. Bouw voor “Release” en “x64”.
  3. De plugin wordt gebouwd als bin/x64/Release/CactbotOverlay.dll.
  4. Voeg de gebouwde plugin direct toe als een ACT-plugin. In het ACT -> Plugins -> Plugin Listing tabblad, klik op de Browse knop en zoek de bin/x64/Release/CactbotOverlay.dll waar dit bestand is gebouwd. Klik dan op Add/Enable Plugin.

npm en webpack

Als u geen cactbot ontwikkelaar bent en cactbot probeert aan te passen voor uw eigen persoonlijke triggers, zou u in plaats daarvan de aanpassingsdocumentatie moeten raadplegen in plaats van uw lokale cactbot bestanden aan te passen.

Om npm te installeren en Webpack te starten, volgt u deze stappen:

  1. Installeer nodejs en npm
  2. Run npm install in de root van de cactbot directory.
  3. Run npm run build of npm start.

Zie de bijdragedocumentatie voor meer details over het gebruik van Webpack.

UI module overzicht

De ui/ directory bevat cactbot’s ui modules.Als u cactbot heeft geinstalleerd volgens de instructies hierboven, zal dit waarschijnlijk %APPDATA%Advanced Combat Tracker\Plugins\cactbot-version\cactbot\ui\ zijn.

Elke cactbot ui module moet worden toegevoegd als een aparte overlay.Zie de Toevoegen Overlay Modules sectie voor meer details over de setup.

raidboss module

Om deze module te gebruiken, richt cactbot op ui/raidboss/raidboss.html of gebruik de Cactbot Raidboss preset.

Deze module geeft een visuele tijdlijn van aankomende gebeurtenissen in een gevecht, evenals tekst en geluidwaarschuwingen om te helpen raid awareness te verhogen. Tekst en geluid alerts kunnen worden gebaseerd op de fighttimeline, of komen van log berichten die in het spel voorkomen, vergelijkbaar met ACT’s “Custom Triggers”. De module is ontworpen om er uit te zien en aan te voelen als de BigWigs Bossmods addon voor World of Warcraft.

Deze pagina geeft een lijst van de momenteel ondersteunde set van inhoud in cactbot.Ondersteuning wordt voortdurend toegevoegd (patches welkom!), maar veel oude inhoud wordt mogelijk nog niet ondersteund.

Vechttijdlijnen worden geleverd in bestanden die zijn ontworpen voor de ACT Timelineplugin, hier gedocumenteerd met enkele uitbreidingen.

Er zijn drie niveaus van tekstwaarschuwingen, in volgorde van escalerend belang: info, alert, en alarm.Tekst berichten zullen in een van deze zijn, en meer belangrijke niveaus zijn groter en meer in het oog springende kleuren. Tekst-naar-spraak kan worden geconfigureerd als u dat prefereert boven tekst op het scherm.

Tijdlijn bestanden en triggers voor tekst en geluid waarschuwingen zijn te vinden in ui/raidboss/data, tijdlijn bestanden met .txt extensie en trigger bestanden met .js extensie.

In deze screenshot, de raidboss module is gemarkeerd, met de tijdlijn omcirkeld in rood, en de tekst waarschuwingen omcirkeld in geel, met een alert-niveau tekstbericht zichtbaar.

raidboss screenshot

raidboss emulator

Als u triggers of tijdlijnen aan het schrijven bent en deze wilt testen, kunt u de raidboss emulator gebruiken:ui/raidboss/raidemulator.html.

Dit kan momenteel alleen in een browser worden geladen en niet als een overlay.Dit werkt in de huidige versie van Chrome,en zou ook in andere browsers moeten werken maar dit is minder getest.

Instructies:

  1. Start ACT.
  2. Zorg ervoor dat de WS Server is gestart via Plugins -> OverlayPlugin WSServer -> Stream/Local Overlay.
  3. Selecteer Cactbot Raidboss (Combined Alerts and Timelines) in de URL Generator lijst.
  4. Bewerk de url om raidemulator.html te zeggen in plaats van raidboss.html.
  5. Kopieer en plak deze bewerkte url in Chrome.
  6. Sleep een netwerk log op de pagina.
  7. Selecteer de zone en de ontmoeting, en klik dan op Load Encounter.

Als de emulator niet werkt, controleer dan het console log in de inspector op fouten.Geen knoppen zullen werken totdat het is verbonden met ACT via websocket.

raidboss emulator screenshot

oopsyraidsy module

Om deze module te gebruiken, richt cactbot op ui/oopsyraidsy/oopsyraidsy.html of gebruik de Cactbot OopsyRaidsy preset.

Deze module zorgt voor het bijhouden van fouten en het rapporteren van sterfgevallen. Oopsy raidsy is bedoeld om de tijd te verminderen die verspild wordt aan het begrijpen wat er fout ging tijdens gevechten en hoe mensen stierven. Tijdens het gevecht wordt slechts een beperkt aantal fouten getoond (om rommel te voorkomen), maar na afloop wordt een volledige scrolbare lijst getoond.

Als iemand sterft, wordt het laatste waar ze schade van hebben opgelopen in het logboek vermeld. Bijvoorbeeld, als het logboek vermeldt: “:schedel: Poutine: Iron Chariot (82173/23703)” betekent dit dat Poutine hoogstwaarschijnlijk is gestorven aan Iron Chariot, die 82173 schade heeft geleden en op dat moment 23703 gezondheid had. De gezondheidswaarde zelf is niet perfect en kan een ~seconde verouderd zijn als gevolg van een hot tick of meerdere gelijktijdige schadebronnen.

Wanneer fouten worden gemaakt die vermijdbaar zijn, logt oopsy waarschuwings (:warning:) en faal (:no_entry_sign:) berichten, waarin wordt uitgelegd wat er mis ging.

Fout triggers worden gespecificeerd voor individuele gevechten in de ui/oopsyraidsy/data map.

oopsy screenshot

banen-module

Om deze module te gebruiken, richt je cactbot op ui/jobs/jobs.html of gebruik je de Cactbot Jobs preset.

Deze module bevat gezondheids- en mana-balken, evenals pictogrammen en timerbalken voor grote raidbuffs zoals The Balance en Trick Attack. Het beschikt ook over een voedsel buff waarschuwing te houden uw voedsel buff wanneer levelingor raiding, en een visuele pull countdown.

Het heeft meer uitgewerkt ondersteuning voor sommige banen, maar is sterk een werk in uitvoering voor anderen.

Ondersteunde Jobs (Klik om uit te breiden)|Job|Feature|:-:|:-:||
Paladin|Het toont huidige Eed bedrag, en verzoening stacks. Houdt ook Goring Blade DoT bij. ||
Scholar toont Aetherflow stacks, Fairy gauge hoeveelheid/ resterende tijd, DoTs resterende tijd, en toont Aetherflow&Lucid Dreaming cooldown.||
Dancer|Toont Combo Timer, Feather Gage, Esprit Gage, Standard Step Cooldown, Technical Step&Flourish Cooldown &Duur.||In deze schermafbeelding is de jobs module voor de Red Mage job uitgelicht. De health- en mana-balken, evenals de witte/zwarte mana-tracking van de Red Mage zijn omcirkeld in paars, met de grote raid buff-tracking ernaast in oranje. De eerste stap van de melee combo is uitgevoerd, die wordt weergegeven als de gele vak boven de gezondheid bar. De proc-tracking is eronder omcirkeld in groen.

jobs screenshot

eureka-module

Om deze module te gebruiken, richt je cactbot op ui/eureka/eureka.html of gebruik je de Cactbot Eureka preset.

Deze module zorgt voor het automatisch volgen van NM’s die zijn geknald of gedood. Het toont storm/nacht timers en elke lokale tracker link die is geplakt in de chat. Eventuele vlaggen in de chat worden ook tijdelijk opgenomen op de kaart.

Het leest momenteel niet de tracker informatie direct. Echter, als je klikt op de linker/rode “Kopieer gesneuvelde NMs” knop in de tracker om de lijst van de huidige dode NMs te kopiëren, kun je het in het spel plakken, bijv./echo ? NMs on cooldown: Serket (7m) > Julika (24m) > Poly (54m)

Als je de emoji niet ziet, controleer dan of je deze Windows update hebt geïnstalleerd.

eureka screenshot

radar module

Om deze module te gebruiken, wijs cactbot naar ui/radar/radar.html of gebruik de Cactbot Radar preset.

Deze module laat je weten of er Hunt Mobs in de buurt zijn (S-rank, A-rank, etc). Als er een verschijnt, geeft het je een pijl (gebaseerd op de richting van je character) en een afstand tot de mob.

Er zijn opties om te laten zien wie de mob heeft getrokken, en om de weergave van de radar te configureren.U kunt ook aangepaste opties instellen voor verschillende rangen (bijv. geluid maken voor S rang, maar stil zijn voor B rangen), of aangepaste triggers instellen voor elke mob naam die u wilt.

Zie de cactbot/user/radar-example.js voor meer opties.

radar screenshot

fisher module

Om deze module te gebruiken, richt cactbot op ui/fisher/fisher.html of gebruik de voorinstelling Cactbot Fisher.

Wanneer je je lijn uitwerpt in een visgat, houdt deze module bij wanneer je een bepaalde vis binnenhengelt, zodat je weet wat je te wachten staat als je hem aan de haak slaat.

visschermopname

De uitwerptijden worden momenteel alleen bijgehouden terwijl je vist, dus er zijn geen gegevens tot je elke vis hebt gevangen. Groene balken zijn lichte sleepboten, gele zijn medium sleepboten en rode balken zijn legendarische/zware sleepboten.

Zie hier voor voorbeelden van de verschillende sleepboottypen.

Kijk hier voor veelvoorkomende tips voor het oplossen van problemen.

dps meters

cactbot kan gebruikt worden met elke dps meter overlay ontworpen voor OverlayPlugin’s miniparseaddon, met de optie om meer functies uit te bouwen via cactbot’s aanvullende JavascriptAPI’s. cactbot stopt ook automatisch gevechten op wipes, zodat je ACT’s vechttijd tot in het oneindige kunt configureren.

De xephero dps meter is gebaseerd op dezelfde dps meter gebouwd voor miniparse, met de extra mogelijkheid om per fase dps tracking te doen, weergegeven in extra kolommen. In de schermafbeelding hieronder zijn de fasen B1, B2, B3 genoemd. Deze worden automatisch gegenereerd uit dungeon-bazen, maar kunnen ook worden gebruikt om onderscheid te maken tussen verschillende fasen in raidgevechten.

xephero screenshot

De dps-meter voor rdmty is gebaseerd op dezelfde dps-meter voor miniparse, maar is bijgewerkt voor Stormblood-taken en opnieuw ingekleurd om overeen te komen met fflogs.

rdmty screenshot

pull counter module

Deze kleine module geeft de huidige pull count voor raiding bosses weer op het scherm.Dit is vooral bedoeld voor mensen die veel streamen en videobeelden willen bekijken. Een getal op het scherm maakt het makkelijk om door de video te bladeren en bepaalde pulls te bekijken.

In de meeste gevallen kun je de telling voor de huidige baas/zone resetten door/echo pullcounter reset te typen. Je kunt de tellingen ook rechtstreeks in je%APPDATA%\Advanced Combat Tracker\Config\RainbowMage.OverlayPlugin.config.jsonbestand bewerken.

pull counter screenshot

test module

Om deze module te gebruiken, richt cactbot op ui/test/test.html of gebruik de Cactbot Test voorinstelling.

Deze module is slechts een test van cactbot variabelen op het scherm en is niet bedoeld om te gebruiken tijdens het spelen. Het kan nuttig zijn om uit te proberen om er zeker van te zijn dat alles werkt zoals verwacht of om te gebruiken om overlay problemen te helpen debuggen.

test screenshot

Troubleshooting

Een algemene FAQ kan hier gevonden worden met oplossingen voor veel voorkomende Cactbot problemen.

Cactbot aanpassen

De meeste Cactbot-configuraties kunnen worden uitgevoerd via het configuratiescherm, binnen ACT.

config-paneel

Dit kan worden gevonden door te gaan naarPlugins -> OverlayPlugin.dll -> Cactbot Event Source, en dan te klikken op options there.

In het bijzonder, als u tekst naar spraak wilt gebruiken voor raidboss waarschuwingen, kunt u de “Default alert output” wijzigen in “TTS Only” of “Text and TTS”. U kunt dit ook wijzigen op een per trigger basis.

Of, als u om wat voor reden dan ook (???)) je de ready check geluidsalarm niet wilt, kun je dit uitschakelen via hetzelfde optie paneel.Ga naar Raidboss -> Algemene Triggers -> Algemeen -> Algemene Ready Check, en stel het in op Disabled in plaats van Defaults.

Deze opties worden opgeslagen in je%APPDATA%\Advanced Combat Tracker\Config\RainbowMage.OverlayPlugin.config.json bestand.Het is niet aan te raden dit bestand direct te bewerken, omdat het strict json moet zijn en ACT zou kunnen falen om te laden als het bestand onjuist is geschreven.

Het wordt aanbevolen dat u het grootste deel van uw configuratie via dit controle paneel doet in plaats van met gebruikers bestanden.Bestanden in cactbot/user/ zijn krachtiger en kunnen alles van het controle paneel overschrijven.Dit kan echter ook verwarrend zijn wanneer het controle paneel iets niet goed aanpast dat een cactbot/user/ bestand stilzwijgend overschrijft.

Zie deze documentatie voor meer details over de gebruiker javascript en css bestanden.

Ondersteunde talen

cactbot is getest en werkt met de huidige internationale (Engels, Duits, Frans, Japans) versie, de huidige Chinese versie, en de huidige Koreaanse versie.Sommige vertalingen zijn nog een werk in uitvoering.

Licenties, handelsmerken, Copyright

Geef een antwoord

Het e-mailadres wordt niet gepubliceerd.