Mods / Vintage Story Content Creator Integration

Tags: #Utility
Author: blakdragan7
Side: Both
Created: Jun 30th 2021 at 8:25 PM
Last modified: Apr 11th 2024 at 9:25 PM
Downloads: 10968
Follow Unfollow 29

Latest release (for Vintage Story 1.19.7, outdated):
vscci_v1.3.1.zip  1-click install


The purpose of this mod is to allow interactions with twitch (and maybe other platforms in the future) chat and your vintage story world

There is a lot planned for this mod but currently it only supports printing events to chat.

To setup you just need to open the config window using the client command ".vscci config"

once thats open you can click on "Login/Connect" to connect your twitch account to vscci. You must use the account you are streaming from. If you want to receive bit / point redemption events you must be either a twitch affiliate or partner. Otherwise you will receive only events like raids, follows and subscriptions.

Once that happens all events are being received

After you are logged in you should see your twtich username and ID in the config window and a status of "Connected"

If you want to disconnect at any time you can press the disconnect button. To re-connect, just click the login button again, Since you are already logged in it will just connect you.

Twitch connections all happen client side, so as many people as want to can be connected to twitch and have evnts run.

If you need help setting up or using vscci check out https://github.com/blakdragan7/vscci/wiki for some information on how to use and setup vscci.

 

Import / Export

To import an event graph, run the command .vscci import path_to_file from the chat window

To export an event graph, run the command .vscci export path_to_file from the chat window

Visual Scripting Language

The scripting language's first iteration is out ! There is some bare bones documentation available at https://github.com/blakdragan7/vscci/wiki/VSCCI-VSL-Tutorial and a video tutorial is available here and a video explaining the 0.3.0 update here There is a video explaining the 1.0 update here

You can open the script editor with the command ".vscci event"

A whitelist (the same whitelist as before) is used to determine who is allowed to execute server side nodes (currently only the run server command node), However; all client side executable nodes are still allowed even without server permission (This was decided because they only affect the user and no one else on the server).

The white list will be under {VintageStoryData install folder}/ModConfig/vscci.json and is just a comma seperated list of usernames inside strings like this

{
    "Whitelist": [

        "blakdragan7",

        "SomeOtherUser123"
    ]
}.

It will require a server restart to pick up any changes made to this file

Streamlabs

Streamlabs is now supported !

Streamlabs support includes:

  • Twitch Events
    • Follow
    • subscription
    • host
    • bits
    • raid
  • Youtube Events
    • subscription
    • sponser
    • super chat
  • Mixer Events
    • supscription
    • follow
    • host
  • Stream Lab Events
    • donation
    • loayalty point redemption

 

Setting up streamlabs is easy. First, make sure the Dropdown next to Stream Platform Type is set to "Streamlabs", Then, Just copy your socket api token from https://streamlabs.com/dashboard#/settings/api-settings under Api Tokens and paste it into the text box next to "Stream Platform Key" Then press Connect Platform. It will now connect you to streamlabs and every startup after will auto connect just like twitch.

 

StreamElements

Streamelements supports basically everything streamlabs does. To setup streamelements First, make sure the Dropdown next to Stream Platform Type is set to "Streamelements". Then, you need the JWT token that you can find by following the cci for minecraft documentation here https://content-creator-integration.readthedocs.io/en/latest/gettingstarted/socketkey/streamelements/ Paste that token into the text box next to "Stream Platform Key" Then press Connect Platform. It will now connect you to Streamelements and every startup after will auto connect just like twitch.

 

Stuff To Be Aware Of:

If both streamlabs and twitch are connected then you will get double events. This will be handle properly in the future.

This is already fixed


With that being said, all twitch information is stored server side, so that you don't have to log in every time you open the game. No login information is stored, only an OAuth token. but I would only log in when the owner of the server is someone you trust (that goes for both dedicated and non dedicated servers) just in case. If you find yourself in a situation where you beleive your account could be compromised you can disconnect the vscci connection from your account and that will invalidate all information assosiated with vscci. That should never happen but it is important to be aware of just in case.

As of 0.0.2, all information is stored client side and the server never sees it. Therefore, the above warning is irrelevent. Thanks to @fireztonez for the suggestion !

This is my first C# project and therfore may have some bugs I didn't catch. Feel free to add those to the github issues from the source link at the top.


Whats Planned For The Future:

In the future I plan to have a working visual scripting system that allows you to have actions performed in world based on twitch events
So for example, you could have a point redemption spawn a drifter near by or even just play a drifter sound near by. Or, you could have a raid spawn a chicken per viewer, or you could start a temporal storm based on a specific point redemption etc etc ...

The first iteration of the scripting language is done ! A detailed video tutorial is coming soon and so is some in depth documentation.

 

That is all coming in the future though and suggestions are welcome !

Mod Version Mod IdentifierFor Game version Downloads Released Changelog Download 1-click mod install*
1.3.1 vscci 212 Apr 11th 2024 at 9:25 PM vscci_v1.3.1.zip 1-click install
  • Fixed crash caused by stream elements changing how their payload looks
  • Fixed crash caused my numbers not being correctly converted to string type in event graph
1.3.0 vscci 158 Apr 4th 2024 at 12:33 AM vscci_v1.3.0.zip 1-click install

updated to 1.19.7

 

streamlabs seems to not work but twitch and stream elemnts do.

Future release may fix streamlabs if i get around to it.

1.2.0 vscci 301 Apr 21st 2023 at 9:15 PM vscci_v1.2.0.zip 1-click install

* Updated dependencies to work with 1.18

1.1.0 vscci 272 Mar 4th 2023 at 5:31 AM vscci_v1.1.0.zip 1-click install

* Added chat interface for import / export of event graphs

1.0.4 vscci 261 Mar 3rd 2023 at 8:49 PM vscci_v1.0.4.zip 1-click install
  • Fixed render bug where connections would require an update before rendering correctly
  • Fixed stale connections from being kept in memory even after being disposed.
1.0.3 vscci 264 Feb 26th 2023 at 6:26 PM vscci_v1.0.3.zip 1-click install
  • Updated to work with 1.18.0-pre *
1.0.2 vscci 396 May 15th 2022 at 7:43 PM vscci_v1.0.2.zip 1-click install
  • Fixed bug that caused events to only work with GUI open
  • Fixed bug that caused connection to not be created between context created nodes
1.0.1 vscci 390 Mar 30th 2022 at 10:46 PM vscci_v1.0.1.zip 1-click install

* Added support for 1.16.4

1.0.0 vscci 484 Aug 19th 2021 at 5:52 AM vscci_v1.0.0.zip 1-click install

Changes:

  • Multi Select Now Available
  • New Drag Select Box
  • Copy / Paste now Available
  • Re Route nodes now available
  • Added Node "Create Waypoint"
  • Added Node "Switch"
  • Added Node "Get Player Position"
  • Added Node "Get Named Player Position"
  • Added Node "Cool Down"
  • Added Node "Random Number"
  • Re created Render Stack Vastly Improving Performance
  • Fixed Memory Leak
  • Fixed Event Dialog sometimes not returning keyboard  input to the player on closing

Notes:

  • This will be the final "Feature" release. From here on out it will just be bug fixes
  • A new youtube tutorial video explaining all the new features will be uploaded to youtube soon
0.4.2 vscci 513 Aug 5th 2021 at 8:55 PM vscci_v0.4.2.zip 1-click install

Changes:

  • Fixed bug with "Run Server Command" node that prevented server commands that required an implcit player from working.

Notes:

  • Before, all server comands were run as admin, thus bypassing the permsion system outside of this mod. Now commands are being run by the player so you need permission to run server commands via the default method in vintage story as well as through this mod (the whitelist config file)
0.4.1 vscci 490 Aug 5th 2021 at 12:56 AM vscci_v0.4.1.zip 1-click install

v0.4.1

Changes:

  • Fix for double events when connected to both twitch and a desired platform (streamlabs or streamelements)

Notes:

  • I can only test this change so much since I'm an actual streamer. Because of this, I am not 100% sure this fix worked. Please give me feedback if it didn't and I will do my best to resolve it.
0.4.0 vscci 462 Aug 4th 2021 at 11:18 PM vscci_v0.4.0.zip 1-click install

v0.4.0

Changes:

  • Added Streamelements Support !
  • Added way to disconnect from either Twitch or desired platform
  • Added way to login to either Twitch or desired platform or both

Notes:

  • You can not be logged into both streamelements and streamlabs
  • you can by logged into either streamelements or streamlabs AND twitch
  • you must be logged into twitch to get point redemption events
0.3.2 vscci 482 Aug 4th 2021 at 6:10 PM vscci_v0.3.2.zip 1-click install

v0.3.2~hotfix

Changes:

  • Fixed crash with append string node
0.3.1 vscci 485 Aug 4th 2021 at 5:54 PM vscci_v0.3.1.zip 1-click install

v0.3.1

Changes:

  • Added Equal to Node
  • Added Not Equal To Node

Notes:

  • I completly forgot to add these (my bad). But here they are now and so now you can actually do something :)
0.3.0 vscci 499 Aug 3rd 2021 at 3:39 AM vscci_v0.3.0.zip 1-click install

v0.3.0

Changes:

  • Changed all Numberic Types to be One Type now called "Number"
  • Added and implemented Hover infomration to nodes and pins
  • Outputs can now go to multiple imputs
  • Context aware node selections menus apear when you drag of a node connection and release in empty space
  • All Node Selection Menus are now Searchable

Notes:

  • Graphs from before 0.3.0 will only partially be loaded correctly. So be aware before updating !
  • An update video is available here.
0.2.2 vscci 464 Jul 31st 2021 at 5:07 PM vscci_v0.2.2.zip 1-click install

v0.2.2

  • Fixed visal glitch with node selection menu
  • Made selection highlight look a little better.
  • Hopefully made so that anyone can connect to a server using this mod even if they don't have this mod installed. but people with this mod gain access to the gui interface for it.
0.2.1 vscci 520 Jul 30th 2021 at 1:45 AM vscci_v0.2.1.zip 1-click install

v0.2.1

* Added Multiply and devide basic nodes

* fixed pin color for doubles

0.2.0 vscci 672 Jul 29th 2021 at 9:43 PM vscci_v0.2.0.zip 1-click install

V0.2.0

Changes:

  • First iteration of visual scripting language is done !
  • Now hide the twitch id when looking at config screen.
  • various bug fixes
  • Updated to 1.15.2

 

Notes:

  • This is a rough start to the scripting language, there is a few little odd things here and there. Feel free to make an issue about anything you find that acts odd or is otherwise hard to use
  • The is currently only two "actions" you can perform with the script. Print to local chat, and execute a server side command. However, it should be pretty powerful even with this limitation
  • More "action" nodes and many other nodes are planned for future release to make the language more powerful
  • A QOL update that should just make using the language easier is planned for future release, But I wanted to get something out and get some feed back as well which is why I'm releasing first

 

 

0.1.0 vscci 499 Jul 18th 2021 at 11:09 PM vscci_v0.1.0.zip 1-click install

Added Support for Streamlabs ! Streamlabs support includes:

  • Twitch Events
    • Follow
    • subscription
    • host
    • bits
    • raid
  • Youtube Events
    • subscription
    • sponser
    • super chat
  • Mixer Events
    • supscription
    • follow
    • host
  • Stream Lab Events
    • donation
    • loayalty point redemption

If both twitch and streamlabs are connected then you will get double prints to chat for now. Next release I will address this and make streamlab events prefered so that if an event can happen in both, only the stream lab events will happen in game

0.0.6 vscci 516 Jul 14th 2021 at 9:59 PM vscci_v0.0.6.zip 1-click install

Moved mod config to the actual stand location. It is located in %appdata%\VintageStoryData\ModConfig. the same mods such as vshud have there configs. Old config files will be picked up and moved over automatically.

0.0.5 vscci 510 Jul 14th 2021 at 6:41 PM vscci_v0.0.5.zip 1-click install

Added bandaid for crash involving emoji parsing
Added section in config GUI that shows wether or not the current user is allowed to post events to the server.

0.0.4 vscci 547 Jul 6th 2021 at 5:03 PM vscci_v0.0.4.zip 1-click install

Modified GUI to have a disconnect button instead of connect, fixing a crash that could happen before. Also, made twitch auto connect if you were previously logged in on startup.

0.0.3 vscci 494 Jul 5th 2021 at 8:13 PM vscci_v0.0.3.zip 1-click install

Added simple white list file for server side to determine who can broadcast chat messages for events. the file is vscci_config.json and should be in the root dir of the cwd of the server.

0.0.2 vscci 530 Jul 5th 2021 at 3:07 AM vscci_v0.0.2.zip 1-click install

Moved all twitch interaction code to client side, only sending reqeust to the server.

It is now irrelevent if you trust the server owner since all auth data is stored and used client side

0.0.1 vscci 547 Jun 30th 2021 at 9:09 PM vscci_v0.0.1.zip 1-click install

Alpha Release 0.0.1


11 Comments (oldest first | newest first)

💬 the_smitchell, Feb 20th at 2:05 PM

Is this project still being developed?

💬 blakdragan7 , Nov 30th 2022 at 1:24 AM

DonnieDreams, it can be used server side only but the client side is required for config. That way, you can have it running on a server and only the host needs the client side mod so they can set it up.

💬 DanaCraluminum, Jul 23rd 2022 at 7:35 PM

It is marked as server side in modinfo and as both server side and client side on here

💬 DonnieDreams, Jul 23rd 2022 at 5:15 PM

Just curios if this is a client side or a seerver side mod?

💬 blakdragan7 , Jul 14th 2021 at 6:23 PM

@FaithlessZealot I will have to check out DLive then !

💬 FaithlessZealot, Jul 13th 2021 at 9:09 PM

I'd be interested if you get Dlive integration in the future!

💬 blakdragan7 , Jul 3rd 2021 at 9:39 PM

@fireztonez, I see. No worries, if you run into anything else let me know !

💬 fireztonez, Jul 3rd 2021 at 11:52 AM

@blakdragan7 I just look and now it is fine for the github, I see the issue tab now. If you didn't change any configuration on your repo, this is possibly a bug when I load your github page, not sure... But I know, when I load the first time I look and the issue page was not there.

💬 blakdragan7 , Jul 3rd 2021 at 12:59 AM

@fireztonez I just created a test github account and tried out making an issue and seemed to be able too. What are you experiancing when you try to make one ?

💬 blakdragan7 , Jul 3rd 2021 at 12:51 AM

Thanks ! You can post the suggestestion here for now if you want. I didn't even know you could do that since the repo itself is public. I will try to sort that out once I get the time

💬 fireztonez, Jul 2nd 2021 at 10:44 PM

This is exactly what I looking for for long time already, thank'you very mutch!

I can't wait to see the progression of that mod, with all the planned feature!!

And by the way, the issue feature on your github repository is not available for everyone, so it is impossible for us to report any bugs or add feature request on those...

 (edit comment delete)
Основной веб-сайт | Почтовый сервер | FTP сервер | Административная панель | API интерфейс | Content Delivery Network | Статические файлы | Ресурсы сайта | Изображения | Файловое хранилище | Блог | Интернет-магазин | Техническая поддержка | Справочная система | Документация | Форум | Новости | Загрузки | Демонстрация | Тестовая среда | Приложение | Медиа контент | Разработка | Промежуточная среда | Бета версия | Безопасная зона | Вход в систему | Панель управления | Портал | Система управления контентом