Skip to content

Latest commit

 

History

History
96 lines (63 loc) · 4.85 KB

README.md

File metadata and controls

96 lines (63 loc) · 4.85 KB
Raw

📜 other templates available at https://github.com/SkyrimScripting/SKSE_Templates

SKSE - Game Events

A simple SKSE plugin for Skyrim using:

  • C++
  • CMake
  • CommonLibSSE NG
    • automatically downloaded using vcpkg integration of CMake

Because this uses CommonLibSSE NG, it supports Skyrim SSE, AE, GOG, and VR!

What does it do?

It writes to a log file whenever certain events in the game happen:

  • Whenever the player or any NPC "activates" something (e.g. opening a door, interacting with an object, etc)
  • Whenever a game menu is opened or closed

There are many more events which you can easily monitor via your SKSE plugins!

To find some, I recommend searching CommonLibSSE for files with TES*Event in their names.

  1. Visit this link: https://github.com/CharmedBaryon/CommonLibSSE-NG
  2. Press the T key to open the fuzzy find file search
  3. Type TESEvent
  4. Choose any of the files that show up! They're probably events that you can get via an event sink 😸

Read plugin.cpp for details on what it's doing!

Requirements

  • Visual Studio 2022 (the free Community edition is fine!)
  • CMake 3.25.1+ (please install the Latest Release)
  • vcpkg
      1. Clone the repository using git OR download it as a .zip
      1. Go into the vcpkg folder and double-click on bootstrap-vcpkg.bat
      1. Edit your system or user Environment Variables and add a new one:
      • Name: VCPKG_ROOT
        Value: C:\path\to\wherever\your\vcpkg\folder\is

Once you have Visual Studio 2022 installed, you can open this folder in basically any C++ editor, e.g. VS Code or CLion or Visual Studio

  • for VS Code, if you are not automatically prompted to install the C++ and CMake Tools extensions, please install those and then close VS Code and then open this project as a folder in VS Code

You may need to click OK on a few windows, but the project should automatically run CMake!

It will automatically download CommonLibSSE NG and everything you need to get started making your new plugin!

Project setup

By default, when this project compiles it will output a .dll for your SKSE plugin into the build/ folder.

If you want to configure this project to output your plugin files into your Skyrim Special Edition's "Data" folder:

  • Set the SKYRIM_FOLDER environment variable to the path of your Skyrim installation
    e.g. C:\Program Files (x86)\Steam\steamapps\common\Skyrim Special Edition

If you want to configure this project to output your plugin files into your "mods" folder:
(for Mod Organizer 2 or Vortex)

  • Set the SKYRIM_MODS_FOLDER environment variable to the path of your mods folder:
    e.g. C:\Users\<user>\AppData\Local\ModOrganizer\Skyrim Special Edition\mods
    e.g. C:\Users\<user>\AppData\Roaming\Vortex\skyrimse\mods

Setup your own repository

If you clone this template on GitHub, please:

  • Go into LICENSE and change the year and change <YOUR NAME HERE> to your name.
  • Go into CODE_OF_CONDUCT.md and change <YOUR CONTACT INFO HERE> to your contact information.

It's good to have a Code of Conduct and GitHub will show your project's CODE_OF_CONDUCT.md in the project sidebar.

If you'd like to know more about open source licenses, see:

If you use this template, PLEASE release your project as a public open source project. 💖

PLEASE DO NOT RELEASE YOUR SKSE PLUGIN ON NEXUS/ETC WITHOUT MAKING THE SOURCE CODE AVAILABLE