Kukoro Dungeon Raid Helper

Setup

Enter Channel Name:
OAuth Token (for streamers):
Click here to get your OAuth Token
Kukoro API usage is temporarily disabled. Skins wont show up, and the Kukoro Only setting will not work.


Settings

Language: custom languages are unsupported for now
Theme:

How to Use

For Viewers

Any viewer can use this tool on any stream if they would like.

On streams that use the tool

Simply type `!helper` in the chat. A link to the tool that will connect to that stream will posted in chat. If for some reason it seems like you are missing data that the streamer has, you can type `!fetch` in the chat and it will pull the latest data from the streamers view.

On streams that do not use the tool

Come to this page, type in the name of the channel you want to use the tool on, and click join. If you click join in the middle of a raid, not all data will be available right away. However it will add data whenever it sees someone do `!getinfo`. If you wait for a new raid to start, everything will appear as normal.

For Streamers

First, type in your Twitch username. Next, grab your OAuth token here, and put it in the OAuth Token box. Finally, click join. It is reccommended to set this up before opening up dungeons to let people join. Once set up, the tool will detect people doing `!kukoro` and `!getinfo` in chat, and list the information it knows about players in a neat view.

Why should I give it an OAuth token?

To send chat messages. By allowing the tool to send chat messages, it can let viewers who also have the tool open to see when you mark players as dead or reset. It also lets viewers see all of the information if they open the tool mid-run. Although giving it an OAuth token will allow the tool to do more, it is not required, and you can choose not to if you really do not want to.

Can viewers look at this too?

Yes! As long as you have given the tool your OAuth token, viewers will be able to type `!helper` in chat to get a link to the tool

For Moderators

If a stream you moderate for uses this tool, heres a list of commands youll be able to use. Streamers can use these commands if they want too.
  • `!dead [name]` - mark someone as dead
  • `!alive [name]` - mark someone as not dead, if you accidentally mark someone as dead when they are not
  • `!cleartemp` - clears all jump highlights
  • `!drhreset` - clears all players
  • `!remove [name]` - removes a single player
While this tool is and will always be free and open source, I would appreciate it if you supported me on patreon.
Having issues? Ask in The Kitchen section of the Team Prism Discord!
"Kukoro: stream chat games" is property of HeyNau. This website is not affiliated with HeyNau.

Changelog


0.7.13

small patch to fix not detecting players with roles because of the emoji in messages in kukoro v1.2.1.1

0.7.11

another small update before the rewrite

  • slghtly changed how special perk properties are styled
  • visually, they should be mostly the same, but now theme extensions can modify them
  • you can set the following css variable values on the .perk class using an extension like stylish or something:
--perk-no-dead // perks that are only active if every party member is alive
--perk-last-alive // perks that are only active if every other party member is dead
--perk-time // based on the current minute being odd/even
--perk-run // perks that let one flee from combat
--perk-swap // perks that exchange health bar
--perk-invert // perks that invert health bar
--perk-reroll // perks that reroll or shuffle perks

0.7.10

a huge rewrite is coming soon, but i wanted to get something out to help with the new !focus command until thats ready

  • should replace the focused enemy when a player uses !focus
  • just incase it doesnt, it will show (switched focus) after the perk info

0.7.9

  • temporarily disabled kukoro api usage

0.7.8

  • some internal refactoring
  • updated skins. added Sea beast fighter, Sea growth fighter, Sea slingshot fighter, Sea fist fighter, Sea stick fighter, Sea sword fighter, Sea string fighter, Sea kick fighter, Sea iron fighter, Irelyth.

0.7.7

  • small bugfix to account for the change in how enemy types are displayed by the game when doing !getinfo
  • small changes to hopefully protect from case changes in the future

v0.7.6

  • fixed streamer skins, and improved skins in general
  • you can now hover over the skin icon to see the name of the skin
  • updated skins. added Sailor Divo, Cowboy diva, Roller diva, Cowboy divo, Easy_ev, SystemZake, Masked Ricky, Elis, Kking Kkug, Revenant.

v0.7.5

  • no longer needs a workaround to get skins from the game
  • made a temporary fix to get !helper and !sync/!fetch to work again
  • now shows the name of the channel the tool is connected to when on the data view
  • added basic french support. should work the same amount as spanish currently does. still want to add full support for all languages at some point

known issue: streamer skins are currently broken as the way they work was changed with the new referral system, as streamers can have an arbitrary number of skins now

v0.7.4

  • enemy type dropdown now only lists races that there are players for
  • improved theme selector: saves the theme, option to use system default
  • no longer incorrectly defaults to level 10 for non-premium chatters, and correctly shows "unknown" before they have done !getinfo
  • names of patreon supports now glow, and get gradient names (if you are a patron, and dont have a gradient name, send me a message!)
  • updated skins. added ooo0273, africanleopard, GGGamesTw, frenchrooster, spanishorange, brazilianarmadillo, canadianmoose, koreantiger, usabull, czechrabbit, russianwolf, dannyvalz (blobby!)
  • skin files are now all lowercase so they can be case-insensitive, as kukoro itself doesnt care about case

v0.7.2 and v0.7.3

  • added kukoro only and sub only toggles
  • now shows "real" level with the current level, as well as max level
  • added !resist and !agile commands that list enemies that have more than the base defense or agility respectively
  • added spawn streamer button to run !kukoro
  • now shows in the status area if you are authenticated or not
  • reverted checking for things like !kukoro_o because that actually no longer works in kukoro
  • changed how commands are checked because things like ! kukoro do work, and those are now picked up
  • now resets if a moderator (or the streamer) does !changegame with a valid game
  • should now show both display name and username for people with japanese/chinese/korean localized names
  • added light theme
  • added oauth link below oauth box
  • team status now shows (alive players / total players) once the game starts
  • fixed yellowclown skin (hopefully)

v0.7.1

more language stuff!

  • basic spanish support. basic things like listing players works, however enemy type, role, and boss filters do not work.
  • no longer checks if the first "argument" of a command is "!kukoro" and things like "!kukoro_o" work for some reason, so these will now add the player to the list as expected.
  • added descriptions for bard and berserk (in english)
  • now shows player role and level of players who own the game without needing !getinfo
  • added some missing skins. specifically, Evil_gamer_tv, earthprotector, fireprotector, humanprotector, mike_and_chill, mrmagicman67, outspacehero, outspaceheroine, outspacetree, outspacewarrior, solegenddairy (hi!), and waterprotector

v0.7.0 (Beta 2)

language + skin update

  • added localization support to most of the interface, but there are no translations to use yet! :(
  • if you want to help translate, dm me on discord (you can find me through the link that should be above)
  • started working on supporting other game languages, they dont actually work yet though
  • added support for getting skins from kukoro. currently requires some setup, detailed in the how to use section
  • fixed a problem that caused the chatbot to need to reconnect more often than it should have. it should disconnect less frequently, and thus miss fewer messages
  • users with localized display names should now appear correctly. note that currently using !dead, !alive, or !remove on such players requires using the display name, the username will not work. this is a known issue and is planned to be fixed. if you have any issues with players with localized display names, please report it either on the gitlab repo or the discord
  • !alive, !dead, and !remove now work even if you use an @ at the start of the name
  • improved scaling/zooming on the front setup page
  • you can now scroll the sidebar if the window is small
  • probably some other stuff i forgot to mention

v0.6.2

changes to the sidebar

  • revamped most of the sidebar
  • added a search bar to the filter section
  • search bar will search text content of player names, roles, and perks
  • added buttons to run getinfo for all players and just players with missing data
  • these buttons will prompt you first so you dont accidentally flood chat
  • forgot to mention this when it was added, but the reset button also prompts so you dont accidentally reset
  • filters now reset when the raid is reset

v0.6.1

small bugfixes

  • actually filters enemy types correctly now, as described in the previous updates notes
  • perks that do not match the enemy type filter are now dimmed

v0.6.0 (Beta 1)

Massive overhaul of a lot of things.

  • Completely revamped the front page
    • made it look a lot nicer
    • added usage directions for viewers, moderators, and streamers
    • made changelog look a lot better, and its generated from a markdown file
    • added some links and stuff
  • Completely revamped the raider list
    • added a spot to show the player skin
      • doesnt fully work yet, still need to figure out how to fetch player skins from the kukoro api
      • there are a few hardcoded skins for certain names for now though
    • choosing both a role and enemy type filter now works
    • players with perks that target all enemies wont be filtered out when you have an enemy type filter selected
      • added a filter option to also include players with perks that target bosses
      • players that are missing data will always be included because its possible their perks are good against that enemy type
    • now highlights certain perks under certain conditions
      • highlights time based perks (even/odd minute)
      • highlights perks that are active if no players are dead, when there are no dead players
        • if there are dead players, such perks are dimmed
      • dims perks that are only active if a player is the last player alive, when there are other players alive

v0.5.0 (Alpha 5)

viewers can now do !fetch in chat to update their view.

  • this will upload some data (the player list and if the game has started or not) to a pastebin, and then send the code in chat
  • it will send the code with another new command, !sync. only the streamer can use this command, but it will download data from the provided paste code and load data from it.
  • streamers can also use this to reload the page. by doing !fetch, refreshing, and then manually running the sync command, you can reload the page and retain data.

v0.4.2

fixed bug that would cause an infinite chain of messages to be sent if you had 2 instances of the page open as the streamer made ui elements dark theme instead of light theme

v0.4.1

you can now scroll the list of players if it is too long to fit on screen

v0.4.0 (Alpha 4)

should correctly ignore chatters doing !kukoro if there are already 16 players fixed reset filters button fixed issue were filters would break if players were missing data updated front-page

Alpha 3

fixed role names and tooltips corrected some things in the enemy type list added button to show data from previous raid now correctly updates the main view when the raid is over moved team and chat status to a new status panel added role filter added reset button some actions will now send commands in chat to update the status for other players:

  • reset
  • toggle alive/dead status
  • clearing highlights

Alpha 2

small bugfixes

Alpha 1

First public release.