{"id":13779799,"url":"https://github.com/kaciexx/FFXIV_Vibe_Plugin","last_synced_at":"2025-05-11T13:31:10.236Z","repository":{"id":65727090,"uuid":"553560570","full_name":"kaciexx/FFXIV_Vibe_Plugin","owner":"kaciexx","description":"A plugin for FFXIV that will let you vibe your controller or toys.","archived":false,"fork":false,"pushed_at":"2024-01-08T14:58:10.000Z","size":492,"stargazers_count":9,"open_issues_count":1,"forks_count":10,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-08-03T18:14:23.443Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kaciexx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2022-10-18T12:03:34.000Z","updated_at":"2024-08-03T18:14:23.443Z","dependencies_parsed_at":"2024-01-15T22:42:07.742Z","dependency_job_id":null,"html_url":"https://github.com/kaciexx/FFXIV_Vibe_Plugin","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaciexx%2FFFXIV_Vibe_Plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaciexx%2FFFXIV_Vibe_Plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaciexx%2FFFXIV_Vibe_Plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kaciexx%2FFFXIV_Vibe_Plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kaciexx","download_url":"https://codeload.github.com/kaciexx/FFXIV_Vibe_Plugin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225056739,"owners_count":17414196,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-03T18:01:09.368Z","updated_at":"2024-11-17T15:30:43.982Z","avatar_url":"https://github.com/kaciexx.png","language":null,"funding_links":["https://patreon.com/kaciexx","https://www.patreon.com/kaciexx","https://paypal.me/kaciedev"],"categories":["Game Mods"],"sub_categories":["FFXIV"],"readme":"# FFXIV Vibe Plugin\n\n\u003cimg src=\"https://img.shields.io/discord/914941648859963503\"/\u003e \u003cimg src=\"https://img.shields.io/github/last-commit/kaciexx/FFXIV_Vibe_Plugin\" /\u003e\n\u003ca href=\"https://patreon.com/kaciexx\"\u003e\u003cimg src=\"https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fshieldsio-patreon.vercel.app%2Fapi%3Fusername%3Dkaciexx%26type%3Dpatrons\u0026style=flat\" alt=\"Support me on Patreon\" /\u003e\u003c/a\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg width=\"200\" height=\"200\" src=\"./images/icon.png\" /\u003e\n\u003c/p\u003e\n\nA plugin for FFXIV that will let you vibe your controller or toys.\n\n## Features\n- Easy UI interface.\n- Connect your device (manually or automatically).\n- Trigger some pattern from chat message.\n    - Custom chat selection.\n    - Custom allowed characters.\n- Trigger some pattern from spells.\n    - Custom spell name.\n    - Custom spell type (damage, heal...).\n    - Custom spell direction (outgoing, incoming, self).\n    - Min and/or max dmg/heal values.\n    - Custom allowed characters.\n- Multiple devices per custom trigger.\n- UI to search through your triggers.\n- Delay start and stop patterns.\n- Custom device and motors.\n- Using RegExp for chat messages and spell names.\n- Define global threshold or threshold per motor.\n- Displaying battery life of devices.\n- Custom patterns per motor (save, with easy import, export).\n- Vibe or trigger a pattern on HP Changed.\n- HP Changed can have custom min/max values or percentages.\n- Priority system (lower priority number will be stopped).\n- Triggers can be activated only if in or out of combat.\n\n\\* Limited to 10 free triggers in the free version.\n\n## Premium features\n- The number of triggers are unlimited.\n- Create multiple profiles.\n- Export/Import triggers.\n\n## Tutorials\n- [How to install and set your first trigger](https://www.youtube.com/watch?v=YYFzVQsC_kc)\n\n## How to obtain your premium token ?\nYou need to register on [Patreon](https://www.patreon.com/kaciexx). Once registered you will receive your token (~15min) by email.\nThen you will need to copy/paste the token in the first tab of the plugin.\n\n## Prerequisites\n- [FFXIV QuickLauncher](https://github.com/goatcorp/FFXIVQuickLauncher).\n- [Intiface Central](https://intiface.com/central/) **NOT Intiface Desktop**\n\n\n## Installation\n1. Launch your game, open `/xlplugins`, go to the settings (bottom left) and in the `Experimental` tab.\n2. Under `Custom Plugin Repositories` add the following url `https://raw.githubusercontent.com/kaciexx/FFXIV_Vibe_Plugin/master/repo.json` and press the \u003ckbd\u003e+\u003c/kbd\u003e icon.\n3. Press the `Save and close` button on the bottom left.\n\nNow you should be able to see `FFXIV Vibe Plugin`. Click install and enjoy.\n\n## How to use\n1. Start `Intiface Central` and click on `Start Server` (top left button). Power on your device, make sure it is connected to Intiface.\n2. In the game. Type: `/fvp`. You should see the configuration panel.\n3. Press the `Connect` button.\n\nWell done !\n\nYou have now FFXIV connected to Intiface. Now you can connect your device to Intiface and you\nshould be able to use them with FFXIV Vibe Plugin.\n\n![ingame](./Docs/screenshot.png)\n\n## Import triggers\n1. Start the game and make sure the plugin is working.\n2. On your computer, go to your `%userprofile%` folder (eg: C:\\\\Users\\\\\u003cyourname\u003e) folder.\n3. The go in the `FFXIV\\_Vibe\\_Plugin` folder (or create if it does not exists)\n4. Add the triggers file you want to import (eg: `MyTrigger.json`)\n5. In the plugin go to the `Triggers` tab and click on `Import Triggers` at the bottom.\n\nThat's it. It should load all of the triggers.\nNote: you can define a custom directory to read/write in the `Options` tab.\n\n## Export triggers\n1. On your computre, go to your `%userprofile%` folder (eg: C:\\\\Users\\\\\u003cyourname\u003e) folder.\n2. Go to the `FFXIV\\_Vibe\\_Plugin` folder (or create if it does not exists)\n3. In the plugin, go to the `Triggers` tab.\n4. Create your triggers (if they does not exist).\n5. Select the trigger you want to export and click on the `Export` button.\n\nThat's it. You should see them in your userprofile directory.\nNote: you can define a custom directory to read/write in the `Options` tab.\n\n## USB Dongle vs Lovense Dongle vs Other\nWe recommend you to use a bluetooth dongle. Here is the one we are using: [TP-Link Nano USB Dongle Bluetooth 5.0](https://www.amazon.fr/gp/product/B09C25VRXD/ref=as_li_tl?ie=UTF8\u0026camp=1642\u0026creative=6746\u0026creativeASIN=B09C25VRXD\u0026linkCode=as2\u0026tag=kaciexx-21\u0026linkId=8b6c8c6e693ab549216c2dacad34e03b)\n\n## Tested devices\n- Microsoft XBox Controller\n- Lovense (*please use bluetooth and not the lovense dongle*):\n    Nora, Hush, Domi, Ferri, Diamo, Edge 2, Gush\n\n## Trigger Packs\nYou can find some unofficial trigger packs here: [Packs](./Packs/README.md)\n\n## Our TODO\nOur current ideas and feedbacks are in: [TODO List](./Docs/TODO.md)\n\n## FAQ\n\n### Troubleshooting\nMake sure you have the [intiface-central](https://intiface.com/central/) and not the old Intiface Desktop.\n1. Make sure your toy is not connected to another device (eg: your phone, your browser...). Disable the bluetooth on your phone.\n2. Make sure the addon is correctly installed (check the installation process again).\n3. Make sure you have the latest version.\n4. Upgrade your Intiface by clicking and installing any updates (`Settings` tab).\n5. Make sure the Intiface is up and running. Go to `Server status` \u003e `Start Server`. You must have one green icon and one red icon on the top right side of the window.\n6. Ingame, make sure the addon is connected to Intiface. Click on `connect` (in the `Connect` tab). Now, go back to Intiface. You should have 2 green icons on the top right side of the window.\n7. Ingame, make sure the IP is either `127.0.0.1` or `0.0.0.0` or your real internal IP (eg: 192.168.1.250)\n8. Ingame and on Intiface: make sure you are using the same `port` **on both sides**. You can try changing it to something\nelse **on both sides**.\n\n### My device is not working correctly\nPlease make sure to test both Bluetooth and the dongle of the device. Choose the one that works best for you.\n\n### My X-Box Controller is not working well\nThis is not related to this plugin. You probably should not use Bluetooth.\n\n### My Lovense Nora is not doing rotations\nPlease stop using Lovense Dongle. Connect using the Lovense Connect or bluetooth. If you don't have bluetooth\nplease buy a bluetooth 5.0 dongle on amazon for 20$.\n\n### The plugin does not connect to Intiface\nPlease make sure you are doing it right.\nMake sure you have the [intiface-central](https://intiface.com/central/) and not the old Intiface Desktop.\n1. Open Intiface and click on the top right side **red** icon.\n2. Uncheck everything but not *WebSocket* and *Bluetooth*. WebSocket should have the following text: \"on [All Interfaces]:12345\"\n3. Click on Start Server (now you should have one *green* icon and one *red* icon on the top right side).\n4. Go to the plugin and click connect (you should have two *green* icons).\nIf this is not working: please try change the IP Address to 127.0.0.1 or your computer IP Address. Also make sure the port\nis 12345 or correspond to the one in Intiface.\n\n### The device disconnect every now and then.\nPlease make sure to follow those steps before asking for help:\n1. Disable all triggers.\n2. Create a new and very simple trigger (eg: vibration on a message). **Make sure it is correctly working**.\n3. Wait twice the amount of time needed to have the issue again. (eg: if it was around 30min, then wait 60min or more).\n\nIf it works, then it's a trigger issue from one you have created. If not:\n1. **Don't stop** the game, **don't stop** Intiface.\n2. Turn **off and on** your controller device.\n3. Let it reconnect to intiface (without restarting intiface app).\n4. Test your trigger again.\nIf it works, then it probably a bluetooth issue. Nothing we can do about.\n\n### How do I share my configuration\nYou can use the import and export feature. It will drop the configuration as a file in the desired folder.\n\n### How does the priority system works ?\nSo regards, the priority system:\n- **Trigger A** with priority 10 is triggered and played.\n- **Trigger B** with priority 20 is being triggered =\u003e **Trigger** A is stop because B has a higher priority.\n- **Trigger A** with priority 10 is retriggered =\u003e **Trigger A** is ignored because of lower priority, **Trigger B** continues to be played.\n\n### How to stop a pattern\nIn this example, if you have a pattern that runs for 25 sec:\n- Create a new trigger called \"Stop Action\"\n- Define your trigger condition (Spell, chat, ...).\n- Add the device(s) you want to stop.\n- Set to Intensity and the value to zero for each motor you want to stop.\n\nWhen the stop trigger is triggered, it will stop your pattern.\n\n**NOTE**: if the priority is higher, it won't let you play your patterns again.\nUnless the \"Stop Action\" trigger have a \"stop after set\".\n\n### Is it possible to vibe at the level of the HP\nAs of today, it's not possible. However, you can create multiple triggers such\nas:\n- Trigger 1: HPChange 10-20%, Strength 20\n- Trigger 2: HPChange 21-30%, Strength 30\n- Trigger 3: HPChange 31-40%, Strength 40\n\n### Gathering trigger\nYou can create gathering triggers. \n- Create a trigger using the type: Chat\n    - Use the text: \"You obtain a XXX\" (replace XXX with the item)\n    - Use the regex: \"You obtain a (.+?)\\.\"\n\nFeel free to adapt it on your needs.\n\n### Steam Deck users\nIf you are encountering network issues related to your plugins, you can set the\nwinver back to Windows 7 from XIVLauncher's Wine settings tab by clicking the\nWine Configuration box. This should fix your network and/or crash issue.\n\n# Terms of service\n\n[Terms of service](./TERMS.md)\n\n# Discord\n- [This plugin discord](https://discord.gg/JnCGxa3gGa)\n- [Ms. Tress #discussion](https://discord.gg/fx5pABsE)\n\n# Donation \u0026 Donors\nDonation link:\n- [https://paypal.me/kaciedev](https://paypal.me/kaciedev)\n- [https://www.patreon.com/kaciexx](https://www.patreon.com/kaciexx)\n\nPlease concider doing a small donation if you like this plugin. We worked a lot, gave a lots of free nights to design it, listening to everything people wanted and doing the implementation.\n\nThanks to:\n- Hooper (36$)\n- Victor (20.70$)\n- Maple (20$)\n- May B (20$)\n- Iris K (20$)\n- Morris (9.50$)\n- PM (1.90$)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkaciexx%2FFFXIV_Vibe_Plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkaciexx%2FFFXIV_Vibe_Plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkaciexx%2FFFXIV_Vibe_Plugin/lists"}