# isnsest/denizen-reflect architecture

> Architecture diagram of the GitHub repository isnsest/denizen-reflect, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/isnsest/denizen-reflect
- Repository: https://github.com/isnsest/denizen-reflect

## Overview

Denizen-Reflect is a Denizen add-on that lets scripts use Java and define script-backed commands, tags, events, placeholders, and proxies. The main workflow is plugin initialization and command registration, followed by script execution: Java expressions are evaluated, while custom behaviors dispatch into Denizen events or queues. Script imports and dynamically compiled classes support that workflow; optional library loading and PlaceholderAPI integration extend it. The graph follows the README and shown source references; links involving unsampled implementations are omitted unless documented or listed in the source index.

Main entry points: [`src/main/java/com/isnsest/denizen/reflect/DenizenReflect.java`](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/DenizenReflect.java) (Plugin initialization), [`src/main/java/com/isnsest/denizen/reflect/util/codegen/ScriptClassRegistry.java`](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/util/codegen/ScriptClassRegistry.java) (Script class registry), [`src/main/java/com/isnsest/denizen/reflect/util/JavaExpressionEngine.java`](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/util/JavaExpressionEngine.java) (Expression engine), [`src/main/java/com/isnsest/denizen/reflect/commands/ProxyCommand.java`](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/commands/ProxyCommand.java) (Java proxies)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Plugin Runtime"]
  node_plugin["Plugin initialization"]
  node_metrics["Metrics<br/>[Metrics.java]"]
end

subgraph group_script["Script Commands"]
  node_command["Custom commands<br/>[Command.java]"]
  node_asyncwhile["Async while"]
  node_invoke["Java invoke<br/>[InvokeCommand.java]"]
  node_section["Script sections"]
  node_eventcmd["Event renaming<br/>[EventCommand.java]"]
end

subgraph group_events["Script Extensions"]
  node_tagcmd["Custom tags<br/>[TagCommand.java]"]
  node_proxy["Java proxies<br/>[ProxyCommand.java]"]
  node_placeholdercmd["Placeholder command"]
  node_custcmd["Custom command event"]
  node_custtag["Custom tag event"]
  node_placeevent["Placeholder event"]
end

subgraph group_java["Java Runtime"]
  node_engine["Expression engine"]
  node_imports["Script imports<br/>[ImportManager.java]"]
  node_libloadcmd["Library command"]
  node_libraries["Library loader<br/>[LibraryLoader.java]"]
  node_registry["Script class registry"]
  node_byteprovider["Bytecode provider"]
  node_bytedata["Bytecode data<br/>[ByteCodeData.java]"]
  node_classpath["Classpath resolver"]
  node_classloader["Script class loader"]
end

node_scripter(("Denizen scripter"))
node_denizen["Denizen core"]
node_placeholderapi["PlaceholderAPI"]

node_scripter -->|"runs scripts"| node_denizen
node_denizen -.->|"loads add-on"| node_plugin
node_plugin -->|"registers"| node_command
node_plugin -->|"registers"| node_asyncwhile
node_plugin -->|"registers"| node_invoke
node_plugin -->|"registers"| node_tagcmd
node_plugin -->|"registers"| node_eventcmd
node_plugin -->|"registers"| node_section
node_plugin -->|"registers"| node_proxy
node_plugin -->|"registers optionally"| node_placeholdercmd
node_plugin -->|"registers optionally"| node_placeevent
node_plugin -->|"registers"| node_libloadcmd
node_plugin -->|"hooks reloads"| node_imports
node_plugin -->|"creates"| node_metrics
node_invoke -->|"evaluates"| node_engine
node_section -->|"wraps values"| node_engine
node_command -->|"fires"| node_custcmd
node_tagcmd -->|"fires"| node_custtag
node_placeholdercmd -->|"uses"| node_placeevent
node_proxy -->|"resolves imports"| node_engine
node_proxy -->|"loads classes"| node_libraries
node_libloadcmd -->|"loads libraries"| node_libraries
node_imports -->|"sets imports"| node_engine
node_imports -->|"initializes"| node_registry
node_engine -->|"resolves classes"| node_registry
node_engine -->|"resolves libraries"| node_libraries
node_registry -->|"resolves classpath"| node_classpath
node_registry -->|"captures bytecode"| node_byteprovider
node_registry -->|"stores bytecode"| node_bytedata
node_registry -->|"loads classes"| node_classloader
node_placeholderapi -.->|"enables integration"| node_plugin

click node_plugin "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/DenizenReflect.java"
click node_metrics "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/util/Metrics.java"
click node_command "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/commands/Command.java"
click node_asyncwhile "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/commands/AsyncWhileCommand.java"
click node_invoke "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/commands/InvokeCommand.java"
click node_section "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/commands/SectionCommand.java"
click node_eventcmd "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/commands/EventCommand.java"
click node_tagcmd "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/commands/TagCommand.java"
click node_proxy "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/commands/ProxyCommand.java"
click node_placeholdercmd "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/commands/PlaceholderCommand.java"
click node_custcmd "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/events/CustomCommandEvent.java"
click node_custtag "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/events/CustomTagEvent.java"
click node_placeevent "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/events/PlaceholderEvent.java"
click node_engine "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/util/JavaExpressionEngine.java"
click node_imports "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/util/ImportManager.java"
click node_libloadcmd "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/commands/LibloadCommand.java"
click node_libraries "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/util/LibraryLoader.java"
click node_registry "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/util/codegen/ScriptClassRegistry.java"
click node_byteprovider "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/util/codegen/ByteCodeProvider.java"
click node_bytedata "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/util/codegen/ByteCodeData.java"
click node_classpath "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/util/codegen/ClasspathResolver.java"
click node_classloader "https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/util/codegen/ScriptClassLoader.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_plugin,node_metrics toneBlue
class node_command,node_asyncwhile,node_invoke,node_section,node_eventcmd toneAmber
class node_tagcmd,node_proxy,node_placeholdercmd,node_custcmd,node_custtag,node_placeevent,node_placeholderapi toneMint
class node_engine,node_imports,node_libloadcmd,node_libraries,node_registry,node_byteprovider,node_bytedata,node_classpath,node_classloader toneRose
class node_scripter,node_denizen toneIndigo
```

## Components

### Plugin Runtime

- [Plugin initialization](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/DenizenReflect.java): `src/main/java/com/isnsest/denizen/reflect/DenizenReflect.java`
- [Metrics](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/util/Metrics.java): `src/main/java/com/isnsest/denizen/reflect/util/Metrics.java`

### Script Commands

- [Custom commands](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/commands/Command.java): `src/main/java/com/isnsest/denizen/reflect/commands/Command.java`
- [Async while](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/commands/AsyncWhileCommand.java): `src/main/java/com/isnsest/denizen/reflect/commands/AsyncWhileCommand.java`
- [Java invoke](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/commands/InvokeCommand.java): `src/main/java/com/isnsest/denizen/reflect/commands/InvokeCommand.java`
- [Script sections](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/commands/SectionCommand.java): `src/main/java/com/isnsest/denizen/reflect/commands/SectionCommand.java`
- [Event renaming](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/commands/EventCommand.java): `src/main/java/com/isnsest/denizen/reflect/commands/EventCommand.java`

### Script Extensions

- [Custom tags](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/commands/TagCommand.java): `src/main/java/com/isnsest/denizen/reflect/commands/TagCommand.java`
- [Java proxies](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/commands/ProxyCommand.java): `src/main/java/com/isnsest/denizen/reflect/commands/ProxyCommand.java`
- [Placeholder command](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/commands/PlaceholderCommand.java): `src/main/java/com/isnsest/denizen/reflect/commands/PlaceholderCommand.java`
- [Custom command event](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/events/CustomCommandEvent.java): `src/main/java/com/isnsest/denizen/reflect/events/CustomCommandEvent.java`
- [Custom tag event](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/events/CustomTagEvent.java): `src/main/java/com/isnsest/denizen/reflect/events/CustomTagEvent.java`
- [Placeholder event](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/events/PlaceholderEvent.java): `src/main/java/com/isnsest/denizen/reflect/events/PlaceholderEvent.java`

### Java Runtime

- [Expression engine](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/util/JavaExpressionEngine.java): `src/main/java/com/isnsest/denizen/reflect/util/JavaExpressionEngine.java`
- [Script imports](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/util/ImportManager.java): `src/main/java/com/isnsest/denizen/reflect/util/ImportManager.java`
- [Library command](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/commands/LibloadCommand.java): `src/main/java/com/isnsest/denizen/reflect/commands/LibloadCommand.java`
- [Library loader](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/util/LibraryLoader.java): `src/main/java/com/isnsest/denizen/reflect/util/LibraryLoader.java`
- [Script class registry](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/util/codegen/ScriptClassRegistry.java): `src/main/java/com/isnsest/denizen/reflect/util/codegen/ScriptClassRegistry.java`
- [Bytecode provider](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/util/codegen/ByteCodeProvider.java): `src/main/java/com/isnsest/denizen/reflect/util/codegen/ByteCodeProvider.java`
- [Bytecode data](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/util/codegen/ByteCodeData.java): `src/main/java/com/isnsest/denizen/reflect/util/codegen/ByteCodeData.java`
- [Classpath resolver](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/util/codegen/ClasspathResolver.java): `src/main/java/com/isnsest/denizen/reflect/util/codegen/ClasspathResolver.java`
- [Script class loader](https://github.com/isnsest/denizen-reflect/blob/main/src/main/java/com/isnsest/denizen/reflect/util/codegen/ScriptClassLoader.java): `src/main/java/com/isnsest/denizen/reflect/util/codegen/ScriptClassLoader.java`

### Other components

- **Denizen scripter**
- **Denizen core**
- **PlaceholderAPI**

## Connections

- Denizen scripter → Denizen core: runs scripts (evidence: `README.md`)
- Denizen core → Plugin initialization: loads add-on
- Plugin initialization → Custom commands: registers (evidence: `src/main/java/com/isnsest/denizen/reflect/DenizenReflect.java`)
- Plugin initialization → Async while: registers (evidence: `src/main/java/com/isnsest/denizen/reflect/DenizenReflect.java`)
- Plugin initialization → Java invoke: registers (evidence: `src/main/java/com/isnsest/denizen/reflect/DenizenReflect.java`)
- Plugin initialization → Custom tags: registers (evidence: `src/main/java/com/isnsest/denizen/reflect/DenizenReflect.java`)
- Plugin initialization → Event renaming: registers (evidence: `src/main/java/com/isnsest/denizen/reflect/DenizenReflect.java`)
- Plugin initialization → Script sections: registers (evidence: `src/main/java/com/isnsest/denizen/reflect/DenizenReflect.java`)
- Plugin initialization → Java proxies: registers (evidence: `src/main/java/com/isnsest/denizen/reflect/DenizenReflect.java`)
- Plugin initialization → Placeholder command: registers optionally (evidence: `src/main/java/com/isnsest/denizen/reflect/DenizenReflect.java`)
- Plugin initialization → Placeholder event: registers optionally (evidence: `src/main/java/com/isnsest/denizen/reflect/DenizenReflect.java`)
- Plugin initialization → Library command: registers (evidence: `src/main/java/com/isnsest/denizen/reflect/DenizenReflect.java`)
- Plugin initialization → Script imports: hooks reloads (evidence: `src/main/java/com/isnsest/denizen/reflect/DenizenReflect.java`)
- Plugin initialization → Metrics: creates (evidence: `src/main/java/com/isnsest/denizen/reflect/DenizenReflect.java`)
- Java invoke → Expression engine: evaluates (evidence: `src/main/java/com/isnsest/denizen/reflect/commands/InvokeCommand.java`)
- Script sections → Expression engine: wraps values (evidence: `src/main/java/com/isnsest/denizen/reflect/commands/SectionCommand.java`)
- Custom commands → Custom command event: fires (evidence: `src/main/java/com/isnsest/denizen/reflect/commands/Command.java`)
- Custom tags → Custom tag event: fires (evidence: `src/main/java/com/isnsest/denizen/reflect/commands/TagCommand.java`)
- Placeholder command → Placeholder event: uses (evidence: `src/main/java/com/isnsest/denizen/reflect/commands/PlaceholderCommand.java`)
- Java proxies → Expression engine: resolves imports (evidence: `src/main/java/com/isnsest/denizen/reflect/commands/ProxyCommand.java`)
- Java proxies → Library loader: loads classes (evidence: `src/main/java/com/isnsest/denizen/reflect/commands/ProxyCommand.java`)
- Library command → Library loader: loads libraries (evidence: `src/main/java/com/isnsest/denizen/reflect/commands/LibloadCommand.java`)
- Script imports → Expression engine: sets imports (evidence: `src/main/java/com/isnsest/denizen/reflect/util/ImportManager.java`)
- Script imports → Script class registry: initializes (evidence: `src/main/java/com/isnsest/denizen/reflect/util/ImportManager.java`)
- Expression engine → Script class registry: resolves classes (evidence: `src/main/java/com/isnsest/denizen/reflect/util/JavaExpressionEngine.java`)
- Expression engine → Library loader: resolves libraries (evidence: `src/main/java/com/isnsest/denizen/reflect/util/JavaExpressionEngine.java`)
- Script class registry → Classpath resolver: resolves classpath (evidence: `src/main/java/com/isnsest/denizen/reflect/util/codegen/ScriptClassRegistry.java`)
- Script class registry → Bytecode provider: captures bytecode (evidence: `src/main/java/com/isnsest/denizen/reflect/util/codegen/ScriptClassRegistry.java`)
- Script class registry → Bytecode data: stores bytecode (evidence: `src/main/java/com/isnsest/denizen/reflect/util/codegen/ScriptClassRegistry.java`)
- Script class registry → Script class loader: loads classes (evidence: `src/main/java/com/isnsest/denizen/reflect/util/codegen/ScriptClassRegistry.java`)
- PlaceholderAPI → Plugin initialization: enables integration
