https://github.com/lualink/luastubgen
Generates Lua stub files with annotations from Java JARs for use with Lua LSPs, enabling IntelliSense and type-aware scripting in your IDE environments. Primarily for use with LuaLink.
https://github.com/lualink/luastubgen
java lua lua-scripting luajit minecraft paper-plugin papermc spigot spigot-plugin
Last synced: 6 months ago
JSON representation
Generates Lua stub files with annotations from Java JARs for use with Lua LSPs, enabling IntelliSense and type-aware scripting in your IDE environments. Primarily for use with LuaLink.
- Host: GitHub
- URL: https://github.com/lualink/luastubgen
- Owner: LuaLink
- Created: 2025-05-02T00:30:27.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2025-05-31T05:49:13.000Z (7 months ago)
- Last Synced: 2025-06-04T22:51:45.290Z (7 months ago)
- Topics: java, lua, lua-scripting, luajit, minecraft, paper-plugin, papermc, spigot, spigot-plugin
- Language: Kotlin
- Homepage: https://lualink.github.io/docs/
- Size: 144 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Lua Stub Generator
A Kotlin-based tool to generate Lua stub files with LuaLS annotations (Teal type defintions planned) from Java source or compiled JARs. Designed for use with [LuaLink](https://github.com/LuaLink/LuaLink).
## Features
- Parses both source and compiled JARs
- Supports LuaLS Teal-style annotations
- Extracts method signatures, field types, and class documentation
- Processes Javadoc comments
- Outputs structured Lua files for use with IDEs and Lua tooling
## Usage
```bash
java -jar lua-stubgen.jar path/to/jar/paper.jar path/to/jar/adventure.jar...
```
# Example output of Bukkit `Player` from Paper sources JAR
```lua
--- Represents a player, connected or not
-- org.bukkit.entity.Player
---@class Player
local Player = {}
---@return Identity
--- Paper start
function Player:identity() end
---@return BossBar>
--- Gets an unmodifiable view of all known currently active bossbars. This currently only returns bossbars shown to the player via #showBossBar(net.kyori.adventure.bossbar.BossBar) and does not contain bukkit org.bukkit.boss.BossBar instances shown to the player.
function Player:activeBossBars() end
---@return Component
--- Gets the "friendly" name to display of this player.
function Player:displayName() end
---@param displayName? Component
---@return nil
--- Sets the "friendly" name to display of this player.
function Player:displayName(displayName) end
---@return string
function Player:getName() end
---@deprecated
---@return string
--- Gets the "friendly" name to display of this player. This may include color. Note that this name will not be displayed in game, only in chat and places defined by plugins.
function Player:getDisplayName() end
---@deprecated
---@param name string
---@return nil
--- Sets the "friendly" name to display of this player. This may include color. Note that this name will not be displayed in game, only in chat and places defined by plugins.
function Player:setDisplayName(name) end
---@param name? Component
---@return nil
--- Sets the name that is shown on the in-game player list. If the value is null, the name will be identical to #getName().
function Player:playerListName(name) end
```