generated from goatcorp/SamplePlugin
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Showing
6 changed files
with
61 additions
and
75 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,47 +1,13 @@ | ||
# SamplePlugin | ||
# SneakOnBy | ||
|
||
Simple example plugin for Dalamud. | ||
Paints the aggression zones around monsters in Deep Dungeons. Supports proximity, sound, and sight based monsters. | ||
|
||
This is not designed to be the simplest possible example, but it is also not designed to cover everything you might want to do. For more detailed questions, come ask in [the Discord](https://discord.gg/3NMcUV5). | ||
Requires [DeepDungeonDex](https://github.com/wolfcomp/DeepDungeonDex) to be installed as well. | ||
|
||
## Main Points | ||
## Usage | ||
|
||
* Simple functional plugin | ||
* Slash command | ||
* Main UI | ||
* Settings UI | ||
* Image loading | ||
* Plugin json | ||
* Simple, slightly-improved plugin configuration handling | ||
* Project organization | ||
* Copies all necessary plugin files to the output directory | ||
* Does not copy dependencies that are provided by dalamud | ||
* Output directory can be zipped directly and have exactly what is required | ||
* Hides data files from visual studio to reduce clutter | ||
* Also allows having data files in different paths than VS would usually allow if done in the IDE directly | ||
Install with custom repo (coming soon). | ||
|
||
Use command `/sneaky` to configure options. | ||
|
||
The intention is less that any of this is used directly in other projects, and more to show how similar things can be done. | ||
|
||
## To Use | ||
### Building | ||
|
||
1. Open up `SamplePlugin.sln` in your C# editor of choice (likely [Visual Studio 2022](https://visualstudio.microsoft.com) or [JetBrains Rider](https://www.jetbrains.com/rider/)). | ||
2. Build the solution. By default, this will build a `Debug` build, but you can switch to `Release` in your IDE. | ||
3. The resulting plugin can be found at `SamplePlugin/bin/x64/Debug/SamplePlugin.dll` (or `Release` if appropriate.) | ||
|
||
### Activating in-game | ||
|
||
1. Launch the game and use `/xlsettings` in chat or `xlsettings` in the Dalamud Console to open up the Dalamud settings. | ||
* In here, go to `Experimental`, and add the full path to the `SamplePlugin.dll` to the list of Dev Plugin Locations. | ||
2. Next, use `/xlplugins` (chat) or `xlplugins` (console) to open up the Plugin Installer. | ||
* In here, go to `Dev Tools > Installed Dev Plugins`, and the `SamplePlugin` should be visible. Enable it. | ||
3. You should now be able to use `/pmycommand` (chat) or `pmycommand` (console)! | ||
|
||
Note that you only need to add it to the Dev Plugin Locations once (Step 1); it is preserved afterwards. You can disable, enable, or load your plugin on startup through the Plugin Installer. | ||
|
||
### Reconfiguring for your own uses | ||
|
||
Basically, just replace all references to `SamplePlugin` in all of the files and filenames with your desired name. You'll figure it out 😁 | ||
|
||
Dalamud will load the JSON file (by default, `SamplePlugin/SamplePlugin.json`) next to your DLL and use it for metadata, including the description for your plugin in the Plugin Installer. Make sure to update this with information relevant to _your_ plugin! | ||
Still a work in progress. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters