Skip to content

lextpf/glyph

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

45 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

glyph

SKSE overlay for actor info and appearance templates

๐Ÿ“– Installation | ๐ŸŽจ Configuration | ๐Ÿ—๏ธ Building | ๐Ÿค Contributing

SKSE Plugin ImGui CommonLibSSE-NG Skyrim CMake License
Quality Gate Status Maintainability Rating Reliability Rating
build tests
Sponsor

An SKSE plugin that renders floating nameplates above NPCs and creatures, displaying names, levels, and custom titles. Features a tier system that assigns unique visual styles based on level, from simple gradients to shimmering rainbows and particle auras. Every aspect is customizable: fonts, colors, effects, distance fading, and more.


Plugin

Important

Skyrim SE 1.5.97 - AE support is available but untested.

  • Built and tested against Nolvus Awakening 6.0.20. The deploy script assumes D:\Nolvus\Instance\MODS\overwrite, edit DEPLOY_PATH in deploy.bat to match your setup.
  • If you experience frame drops, type glyph in the console to toggle the overlay off.
/* ============================================================================================== *
 *                                                             โ €    โ €โ €โก„โ €โ €โ €โ €โ €โ €โฃ โ €โ €โข€โ €โ €โข โ €โ €โ €
 *                                                             โ €     โขธโฃงโ €โ €โ €โ €โข โฃพโฃ‡โฃ€โฃดโฃฟโ €โ €โฃผโก‡โ €โ €
 *                                                                โ €โ €โฃพโฃฟโฃงโ €โ €โข€โฃผโฃฟโฃฟโฃฟโฃฟโฃฟโ €โฃผโฃฟโฃทโ €โ €
 *                                                                โ €โขธโฃฟโฃฟโฃฟโก€โ €โ ธโ ฟโ ฟโฃฟโฃฟโฃฟโกŸโข€โฃฟโฃฟโฃฟโก‡โ €
 *        ::::::::  :::     :::   ::: :::::::::  :::    :::       โ €โฃพโฃฟโฃฟโฃฟโฃฟโก€โ €โข€โฃผโฃฟโฃฟโกฟโ โฃฟโฃฟโฃฟโฃฟโฃทโ €
 *       :+:    :+: :+:     :+:   :+: :+:    :+: :+:    :+:       โขธโฃฟโฃฟโฃฟโฃฟโ โฃ โฃคโฃพโฃฟโฃฟโฃฏโฃคโฃ„โ ™โฃฟโฃฟโฃฟโฃฟโก‡
 *       +:+        +:+      +:+ +:+  +:+    +:+ +:+    +:+       โฃฟโฃฟโฃฟโฃฟโฃฟโฃถโฃฟโฃฟโฃฟโฃฟโฃฟโฃฟโฃฟโฃฟโฃถโฃฟโฃฟโฃฟโฃฟโฃฟ
 *       :#:        +#+       +#++:   +#++:++#+  +#++:++#++       โ ˜โขฟโฃฟโฃฟโฃฟโฃฟโฃฟโฃฟโฃฟโฃฟโฃฟโฃฟโฃฟโฃฟโฃฟโฃฟโฃฟโฃฟโฃฟโก
 *       +#+   +#+# +#+        +#+    +#+        +#+    +#+       โ €โ ˜โขฟโฃฟโฃฟโฃฟโ ›โ ปโขฟโฃฟโฃฟโฃฟโ นโ Ÿโฃฟโฃฟโฃฟโฃฟโฃฟโ €
 *       #+#    #+# #+#        #+#    #+#        #+#    #+#       โ €โ €โ ˜โขฟโฃฟโฃฟโฃฆโก„โขธโฃฟโฃฟโฃฟโก‡โ  โฃฟโฃฟโฃฟโฃฟโก‡โ €
 *        ########  ########## ###    ###        ###    ###       โ €โ €โ €โ ˜โขฟโฃฟโฃฟโ €โฃธโฃฟโฃฟโฃฟโ ‡โ €โ ™โฃฟโฃฟโฃฟโ โ €
 *                                                                โ €โ €โ €โ €โ ˜โฃฟโ ƒโขฐโฃฟโฃฟโฃฟโก‡โ €โ €โ €โ ˆโขปโก‡โ €โ €
 *                                                                โ €โ €โ €โ €โ €โ ˆโ €โ ˆโขฟโฃฟโฃฟโฃฟโฃถโกถโ ‚โ €โ €โ โ €โ €
 *                                << S K Y R I M   P L U G I N >>         โ €โ €โ ˆโ ปโฃฟโกฟโ ‹โ €โ €โ €โ €โ €โ €โ €
 *                                                                                                  
 * ============================================================================================== */

Features

Visual Effects System

---
config:
  look: handDrawn
  theme: mc
  themeVariables:
    fontSize: 18px
  layout: elk
---
graph LR
    classDef gradient fill:#1e3a5f,stroke:#3b82f6,color:#e2e8f0
    classDef vertical fill:#1a3350,stroke:#60a5fa,color:#e2e8f0
    classDef diagonal fill:#172e48,stroke:#93c5fd,color:#e2e8f0
    classDef radial fill:#14283f,stroke:#38bdf8,color:#e2e8f0
    classDef shimmer fill:#3b1f7e,stroke:#a78bfa,color:#e2e8f0
    classDef chromatic fill:#2e1a6e,stroke:#c084fc,color:#e2e8f0
    classDef pulse fill:#4c1d95,stroke:#e879f9,color:#e2e8f0
    classDef rainbow fill:#064e3b,stroke:#34d399,color:#e2e8f0
    classDef conic fill:#065f46,stroke:#6ee7b7,color:#e2e8f0
    classDef fire fill:#7c2d12,stroke:#f97316,color:#fef3c7
    classDef sparkle fill:#713f12,stroke:#facc15,color:#fef9c3

    subgraph Basic["๐ŸŽจ Basic Effects"]
        G["๐ŸŽจ Gradient"]:::gradient
        VG["โ†•๏ธ Vertical"]:::vertical
        DG["โ†—๏ธ Diagonal"]:::diagonal
        RG["๐Ÿ”˜ Radial"]:::radial
    end

    subgraph Advanced["๐Ÿ’Ž Advanced Effects"]
        S["๐Ÿ’  Shimmer"]:::shimmer
        CS["๐Ÿ”ฎ Chromatic Shimmer"]:::chromatic
        P["๐Ÿ’— Pulse"]:::pulse
    end

    subgraph Special["๐Ÿ”ฅ Special Effects"]
        RW["๐ŸŒˆ Rainbow Wave"]:::rainbow
        CR["๐ŸŒ€ Conic Rainbow"]:::conic
        F["๐Ÿ”ฅ Fire"]:::fire
        SP["โœจ Sparkle"]:::sparkle
    end
Loading
  • Gradients - Horizontal, vertical, diagonal, and radial color blending
  • Shimmer - Moving highlight bands with chromatic aberration option
  • Rainbow - Animated wave and conic rainbow patterns
  • Fire/Sparkle - Dynamic elemental effects for legendary tiers

Tier System

Customizable tiers with unique visual styles per level range:

Tier Default Title Style
0-4 ๐ŸŒฟ Lost Wanderer Simple gradient
4-8 โš”๏ธ Apprentice Progressive effects
8-12 ๐Ÿ›ก๏ธ Radiant Ornaments + particles
12+ ๐Ÿ‘‘ Legend Full rainbow + all effects

Rendering Features

  • ๐ŸŒซ๏ธ Distance-based fading - Smooth alpha and scale transitions
  • ๐Ÿงฑ Occlusion culling - Names hidden behind walls
  • ๐ŸŒŸ Glow effects - Soft bloom for readability
  • โŒจ๏ธ Typewriter reveal - Characters appear one-by-one
  • ๐ŸŒฟ Side ornaments - Ornate scrollwork for high tiers
  • โœจ Particle auras - Stars, sparks, wisps, runes, orbs

Technology Stack

Component Technology
Language C++23
Graphics D3D11
Overlay ImGui
Font Rendering FreeType 2
Assembly xbyak
Framework CommonLibSSE-NG
Logging spdlog

Installation

Pack the build output into the SKSE folder structure and install with your mod manager:

Data/
+-- SKSE/
    +-- Plugins/
        |-- glyph.dll
        |-- glyph.ini
        +-- glyph/
            +-- (assets)

Mod Organizer 2: Install from archive and enable.

Vortex: Drag and drop the archive, deploy mods.

Configuration

Edit Data/SKSE/Plugins/glyph.ini โ€” press F7 in-game to hot reload.

---
config:
  look: handDrawn
  theme: mc
  themeVariables:
    fontSize: 18px
  layout: elk
---
graph LR
    classDef display fill:#1e3a5f,stroke:#3b82f6,color:#e2e8f0
    classDef distance fill:#1a3350,stroke:#60a5fa,color:#e2e8f0
    classDef effects fill:#3b1f7e,stroke:#a78bfa,color:#e2e8f0
    classDef particles fill:#2e1a6e,stroke:#c084fc,color:#e2e8f0
    classDef tiers fill:#064e3b,stroke:#34d399,color:#e2e8f0
    classDef template fill:#7c2d12,stroke:#f97316,color:#fef3c7

    subgraph Display["๐Ÿ“ Display"]
        FMT["๐Ÿ“‹ Format"]:::display
        FONT["๐Ÿ”ค Fonts"]:::display
        VERT["๐Ÿ“ VerticalOffset"]:::display
    end

    subgraph Distance["๐Ÿ“ Distance & Fade"]
        FADE["๐ŸŒซ๏ธ FadeStart/End"]:::distance
        SCALE["๐Ÿ” ScaleStart/End"]:::distance
        SCAN["๐Ÿ“ก MaxScanDistance"]:::distance
    end

    subgraph Effects["โœจ Visual Effects"]
        GLOW["๐ŸŒŸ Glow"]:::effects
        TYPE["โŒจ๏ธ Typewriter"]:::effects
        ORNA["๐ŸŒฟ Ornaments"]:::effects
    end

    subgraph Particles["๐Ÿ’ซ Particle Aura"]
        STAR["โญ Stars"]:::particles
        SPARK["๐Ÿ”ฅ Sparks"]:::particles
        WISP["๐Ÿ‘ป Wisps"]:::particles
        RUNE["๐Ÿ”ฎ Runes"]:::particles
        ORB["๐Ÿ”ต Orbs"]:::particles
    end

    subgraph Tiers["๐Ÿ… Tier Definitions"]
        TIER["๐ŸŽจ Colors & Effects"]:::tiers
        LEVEL["๐Ÿ“Š Level Ranges"]:::tiers
    end

    subgraph Template["๐Ÿ‘ค Appearance"]
        NPC["๐Ÿง TemplateFormID"]:::template
        PLUGIN["๐Ÿ“ฆ TemplatePlugin"]:::template
    end
Loading

Building

Prerequisites

  • CMake 3.10+
  • C++23 compatible compiler (MSVC 2022+)
  • vcpkg
  • Skyrim SE 1.5.97
  • SKSE64
  • Address Library for SKSE Plugins

Windows

# 1. Clone the repository
git clone https://github.com/lextpf/glyph.git
cd glyph

# 2. Build
.\build.bat

# 3. Deploy to Skyrim (adjust path in deploy.bat)
.\deploy.bat

Output: build/Release/glyph.dll

Architecture

---
config:
  look: handDrawn
  theme: mc
  themeVariables:
    fontSize: 18px
  layout: elk
---
graph TB
    classDef core fill:#1e3a5f,stroke:#3b82f6,color:#e2e8f0
    classDef hook fill:#2e1f5e,stroke:#8b5cf6,color:#e2e8f0
    classDef render fill:#134e3a,stroke:#10b981,color:#e2e8f0

    Main["๐Ÿš€ main.cpp"]:::core
    Settings["โš™๏ธ Settings"]:::core
    Hooks["๐Ÿช Hooks"]:::hook
    Renderer["๐ŸŽจ Renderer"]:::render
    Effects["โœจ TextEffects"]:::render

    Main --> Settings
    Main --> Hooks
    Hooks --> Renderer
    Renderer --> Effects
Loading
File Purpose
main.cpp Plugin initialization, SKSE interface
Hooks.cpp D3D11 and HUD menu hooks
Renderer.cpp World-to-screen projection, tracking
Settings.cpp INI parsing and configuration
TextEffects.cpp Visual effect implementations

Project Structure

glyph/
|-- src/                          # Source code
|   |-- main.cpp                  # Entry point, SKSE interface
|   |-- Hooks.cpp/h               # D3D11 present and HUD menu hooks
|   |-- Renderer.cpp/h            # World-to-screen projection
|   |-- TextEffects.cpp/h         # Visual effect implementations
|   |-- Settings.cpp/h            # ini parsing and configuration
|   |-- Occlusion.cpp/h           # Raycast visibility checks
|   |-- ParticleTextures.cpp/h    # Particle sprite atlas generation
|   |-- AppearanceTemplate.cpp/h  # NPC appearance copying
|   |-- DebugOverlay.cpp/h        # Debug HUD
|   |-- RenderConstants.h         # Shared rendering constants
|   |-- PCH.h
|   +-- Version.h
|-- skse/plugins/                 # Runtime assets
|   |-- glyph.ini                 # Default config
|   +-- glyph/
|       |-- fonts/                # Custom fonts
|       +-- particles/            # Particle sprites
|-- external/                     # Third-party sources
|-- CMakeLists.txt                # Build configuration
|-- CMakePresets.json             # CMake presets
+-- vcpkg.json                    # Dependencies

Troubleshooting

Problem Solution
Names don't appear Check SKSE is loaded (getskseversion in console)
No names in combat Intended behavior - overlay disabled during combat
Performance issues Reduce MaxScanDistance, disable complex effects
Fonts not loading Verify paths in INI, ensure TTF format

Check Documents/My Games/Skyrim Special Edition/SKSE/glyph.log for errors.

Contributing

Contributions are welcome! Please read the Contributing Guidelines before submitting pull requests.

Development Workflow

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Make your changes
  4. Run tests and ensure the build passes
  5. Commit with descriptive messages
  6. Push to your fork and open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

About

SKSE mod for Skyrim SE with actor info tiers and appearance cloning built with C++23, ImGUI/D3D11, FreeType and CommonLibSSE-NG.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors