From 4d83420922caeb2861187a6c6fb7d0cc167be03c Mon Sep 17 00:00:00 2001 From: Anna Clemens Date: Sat, 5 Jun 2021 15:46:59 -0400 Subject: [PATCH] chore: add readme --- README.md | 42 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..598aed3 --- /dev/null +++ b/README.md @@ -0,0 +1,42 @@ +# DalamudPython + +Run Python from the chat box. + +## Install + +- Add `https://plugins.annaclemens.io/unofficial` to your custom repos. +- Install Python REPL via `/xlplugins`. + +## Usage + +All scripts have access to an `interface` variable, which is the plugin's `DalamudPluginInterface`. + +In addition, this preamble is appended before every script: + +```py +import clr +from Dalamud import * +from Dalamud.Plugin import * +from Lumina import * +from Lumina.Excel.GeneratedSheets import * +``` + +All errors are logged in the Dalamud Log (`/xllog`). + +### `/py` +Execute Python. + +### `/pyprint` +Execute Python and print the result to chat. + +### `/pyadd` +Add a line to a temporary script. + +### `/pyreset` +Reset the temporary script. + +### `/pyexecute` +Run the temporary script. + +### `/pyload` +Load a Python file. You can provide an absolute or relative path. Relative paths are relative to the plugin's configuration folder.