KobaltBlu/KotOR.js

GitHub: KobaltBlu/KotOR.js

使用TypeScript重写的Odyssey游戏引擎,让经典游戏《星球大战:旧共和国武士》系列可在现代浏览器和桌面环境中运行。

Stars: 128 | Forks: 15

# KotOR.js ![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge&logo=typescript&logoColor=white) ![JavaScript](https://img.shields.io/badge/JavaScript-323330?style=for-the-badge&logo=javascript&logoColor=F7DF1E) ![THREE JS](https://img.shields.io/badge/ThreeJs-black?style=for-the-badge&logo=three.js&logoColor=white) ![Electron](https://img.shields.io/badge/Electron-2B2E3A?style=for-the-badge&logo=electron&logoColor=9FEAF9) ![Node JS](https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=nodedotjs&logoColor=white) ![NPM](https://img.shields.io/badge/npm-CB3837?style=for-the-badge&logo=npm&logoColor=white) ![Webpack](https://img.shields.io/badge/Webpack-8DD6F9?style=for-the-badge&logo=Webpack&logoColor=white) ![KotOR.js](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/af536253bf074127.png) **使用 JS (TypeScript) 重写的 Odyssey 游戏引擎,该引擎曾用于支持 KotOR I & II** KotOR.js 是基于 TypeScript 对 Odyssey 游戏引擎的重制实现,原引擎用于支持《星球大战:旧共和国武士》及其续作《KotOR II:西斯 lords (TSL)》。该项目旨在支持原引擎的完整功能集。虽然仍处于早期开发阶段,但许多系统已经以某种形式上线运行。 除了游戏引擎外,该项目还包括一个名为 KotOR Forge 的早期模组制作套件。 ## 技术栈 - 代码已使用 TypeScript 重写,并编译为 JavaScript。 - THREE.js 被用作渲染引擎的基础。 - Electron 用于打包和发布桌面应用程序。 [讨论帖](https://deadlystream.com/topic/6608-wip-kotor-js-a-game-engine-for-k1-k2-written-in-javascript/) [KotOR.js Youtube 频道](https://www.youtube.com/channel/UC7b4RL2mj0WJ7fEvbJePDbA) [![OpenKotOR Discord](https://discordapp.com/api/guilds/739590575359262792/widget.png?style=banner2)](https://discord.gg/QxjqVAuN8T) ## 支持的游戏 目前支持以下游戏: - [x] [Star Wars: Knights of the Old Republic (PC)](https://en.wikipedia.org/wiki/Star_Wars:_Knights_of_the_Old_Republic) - [x] [Star Wars: Knights of the Old Republic II The Sith Lords (PC)](https://en.wikipedia.org/wiki/Star_Wars_Knights_of_the_Old_Republic_II:_The_Sith_Lords) ## 系统要求 如果您想使用 KotOR.js 来读取任一游戏的文件,您需要在系统上安装 KotOR I 或 KotOR II 的有效副本。本项目不分发任何游戏文件。 ## Web 兼容性(新) [浏览器兼容性表](https://github.com/KobaltBlu/KotOR.js/wiki/Browser-Support) 近期向 TypeScript 的过渡为代码库带来了许多改进,包括对 Chrome 的支持。当项目编译完成后,`dist` 文件夹的内容可以上传至 Web 服务器。唯一的要求是必须通过有效的 SSL 证书访问该站点。建议使用最新版本的 Chrome。 [![Demo Icon]][Demo Link] ## 快速入门(开发者) 要作为开发者开始使用,请按照以下步骤操作: 1. 下载并安装 [npm (Node Package Manager)](https://www.npmjs.com/get-npm)。 2. 克隆 KotOR.js 仓库。 3. 安装 npm 依赖项。 ``` npm install ``` 4. 运行构建命令 ``` npm run webpack:dev-watch ``` 5. 在单独的控制台/shell 窗口中运行启动命令 ``` npm run start ``` 6. 尽情享受吧 ## 截图
| **KotOR.js 启动器** | **KotOR - Taris: Undercity** | **KotOR - Dantooine** | |:-------------------------:|:-------------------------:|:-------------------------:| | ![KotOR.js Launcher](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/4b6cc4eab7074129.jpg) | ![KotOR - Taris: Undercity](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/f95a15ec85074130.jpg) | ![KotOR - Dantooine](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/1dddab877c074131.jpg) | | **KotOR II - TSL: Awaken Scene** | **KotOR II - TSL: Awaken Scene 2** | | | ![KotOR II - TSL: Awaken Scene](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/2d1e114624074133.jpg) | ![KotOR II - TSL: Awaken Scene 2](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/08a6121084074134.jpg) |
## 视频
| **KotOR.js (2023) - In Browser Demo** | **KotOR JS - Combat Animations Progress Jan 2021** | **KotOR Forge - WIP: Lip Sync Editor Jan 2019** | |:---:|:---:|:---:| | [![KotOR.js (2023) - In Browser Demo](https://img.youtube.com/vi/ZT_9vKRC1t8/0.jpg)](https://www.youtube.com/watch?v=ZT_9vKRC1t8) | [![KotOR JS - Combat Animations Progress Jan 2021](https://img.youtube.com/vi/4oQ8nj_zO-w/0.jpg)](https://www.youtube.com/watch?v=4oQ8nj_zO-w) | [![KotOR Forge - WIP: Lip Sync Editor Jan 2019](https://img.youtube.com/vi/4s4uTyP5yqA/0.jpg)](https://www.youtube.com/watch?v=4s4uTyP5yqA) | **KotOR JS - Lighting & Lipsync Progress Nov 2018** | **KotOR JS : TSL - Gameplay Compilation Sep 2018** | **KotOR JS: The Endar Spire Sep 2018** | [![KotOR JS - Lighting & Lipsync Progress Nov 2018](https://img.youtube.com/vi/2SATn5W2sb4/0.jpg)](https://www.youtube.com/watch?v=2SATn5W2sb4) | [![KotOR JS : TSL - Gameplay Compilation Sep 2018](https://img.youtube.com/vi/IpP6BQJ5ZBQ/0.jpg)](https://www.youtube.com/watch?v=IpP6BQJ5ZBQ) | [![KotOR JS: The Endar Spire](https://img.youtube.com/vi/y2UzOH5bcAQ/0.jpg)](https://www.youtube.com/watch?v=y2UzOH5bcAQ)
## 影响与致谢 如果没有下面这些人,我不可能走到今天这一步。 [xoreos](https://xoreos.org/) [KotOR 模组社区](https://deadlystream.com/) 以及许多许多其他人! ## 许可证 [GPL 3.0 (GNU General Public License)](LICENSE.md)
标签:3D渲染, CMS安全, Electron, GNU通用公共许可证, JavaScript, KotOR, KotOR Forge, MITM代理, Node.js, Odyssey引擎, RPG, Three.js, TypeScript, Webpack, 云资产清单, 响应拦截, 安全插件, 开源游戏, 数据可视化, 旧共和国武士, 星球大战, 桌面应用, 模组工具, 游戏开发, 游戏引擎, 自动化攻击, 逆向工程, 重制版