PyToolsgr 0.0.2

A lightweight 2D/3D game engine based on Ursina

帮助文档（中文版）

• 创建窗口

PyToolsgr.OS(OS) # Windows , MacOS , Linux

game = PyToolsgr.game(分辨率数组,是否全屏,窗口标题,是否可以调整窗口大小,最大帧率,是否显示帧率,是否开启物理引擎,2d或3d)

2D 模式 '''python from PyToolsgr import * PyToolsgr.OS('Windows') # 或MacOS , Linux

x = (1080,720) # 窗口大小 all = True # 是否全屏 title = 'PyToolsgr' # 窗口标题 y = True # 是否可以调整窗口大小 fps = 60 # 最大帧率 fpsx = True # 是否显示帧率 phy = True # 是否开启物理引擎 mode = '2d' # 2d或3d

game = PyToolsgr.game(x,all,title,y,fps,fpsx,phy,mode)

PyToolsgr.beijing((0,0,0)) # 背景颜色

b1 = PyToolsgr.New("Block",(100,100) # 显示大小,rgb(0,0,0),(0,0)#创建位置,phy_ = (100,100)#碰撞大小)

png1 = PyToolsgr.New("PNG",(100,100)#大小,(0,0)#创建位置)

t1 = PyToolsgr.New("Text",(100,100)#大小,(0,0)#创建位置,text="Hello World",font_size=30)

p1 = PyToolsgr.New("Player",(100,100)#大小,(0,0)#创建位置,"player.png"#玩家贴图)

PyToolsgr.look(p1) # 显示

PyToolsgr.look_n(p1) # 隐藏

PyToolsgr.look_a([p1,b1]) # 显示多个对象 PyToolsgr.look_n_a([p1,b1]) # 隐藏多个对象 PyToolsgr.set_pos(p1,(100,100)) # 设置位置 PyToolsgr.set_pos_a([p1,b1],(100,100)) # 设置多个对象位置

game.run() '''

from bilibili:方块之巢 youtube:Block_Nest

Help Documentation (English Version)

• Create Window

PyToolsgr.OS(OS) # Windows , MacOS , Linux

game = PyToolsgr.game(resolution_array,fullscreen,window_title,resizable,max_fps,show_fps,enable_physics,2d_or_3d)

2D Mode '''python from PyToolsgr import * PyToolsgr.OS('Windows') # or MacOS , Linux

x = (1080,720) # window size all = True # fullscreen title = 'PyToolsgr' # window title y = True # resizable fps = 60 # max fps fpsx = True # show fps phy = True # enable physics mode = '2d' # 2d or 3d

game = PyToolsgr.game(x,all,title,y,fps,fpsx,phy,mode)

PyToolsgr.beijing((0,0,0)) # background color

b1 = PyToolsgr.New("Block",(100,100) # display size,rgb(0,0,0),(0,0)#creation position,phy_ = (100,100)#collision size)

png1 = PyToolsgr.New("PNG",(100,100)#size,(0,0)#creation position)

t1 = PyToolsgr.New("Text",(100,100)#size,(0,0)#creation position,text="Hello World",font_size=30)

p1 = PyToolsgr.New("Player",(100,100)#size,(0,0)#creation position,"player.png"#player texture)

PyToolsgr.look(p1) # show

PyToolsgr.look_n(p1) # hide

PyToolsgr.look_a([p1,b1]) # show multiple objects PyToolsgr.look_n_a([p1,b1]) # hide multiple objects PyToolsgr.set_pos(p1,(100,100)) # set position PyToolsgr.set_pos_a([p1,b1],(100,100)) # set position for multiple objects

game.run() '''

from bilibili:Block Nest youtube:Block_Nest# PyToolsgr - 2D/3D Game Engine based on Ursina

PyToolsgr是一个基于Ursina的轻量级2/3D游戏引擎，旨在简化游戏开发流程，提供直观的API和丰富的功能。

特性

• 🎮 简单易用的2D/3D游戏开发API
• 🚀 基于Ursina引擎，继承其高性能和灵活性
• 📦 开箱即用的游戏对象和组件系统
• 🎨 内置精灵、动画、粒子效果支持
• 🎯 碰撞检测和物理系统
• 🎵 音频管理
• 📱 跨平台支持（Windows, MacOS, Linux）
• 📖 详细的文档和示例

安装

通过pip安装PyToolsgr：

pip install PyToolsgr

快速开始

创建窗口

from PyToolsgr import PyToolsgr

# 设置操作系统
PyToolsgr.OS('Windows')

# 窗口参数
resolution = (1080, 720)  # 窗口大小
fullscreen = False      # 是否全屏
title = 'PyToolsgr'     # 窗口标题
resizable = True        # 是否可以调整窗口大小
fps_limit = 60          # 最大帧率
show_fps = True         # 是否显示帧率
physics = True          # 是否开启物理引擎
mode = '2d'             # 2d或3d

# 创建游戏窗口
game = PyToolsgr.game(
    resolution=resolution,
    fullscreen=fullscreen,
    title=title,
    resizable=resizable,
    fps_limit=fps_limit,
    show_fps=show_fps,
    physics=physics,
    mode=mode
)

# 运行游戏
game.run()

核心概念

• 有2个模式
• 复杂模式:可以有更强的功能但是更难
• 极简模式:新手能轻松上手不需要看复杂的文档

游戏对象

"player" 玩家 "NPC" 游戏NPC “block”方块，一个基本单位，不一定是正方形 "PNG" PNG 的贴图

帮助文档

1. 创建窗口

PyToolsgr.OS(OS) # Windows , MacOS , Linux

game = PyToolsgr.game(分辨率数组,是否全屏,窗口标题,是否可以调整窗口大小,最大帧率,是否显示帧率,是否开启物理引擎,2d或3d)

2. 设置背景颜色

PyToolsgr.beijing((0,0,0)) # 背景颜色，如黑色

3. 创建游戏对象

# 创建方块
b1 = PyToolsgr.New("Block",(100,100),position=(0,0),color=color.red,phy_=(100,100))

# 创建PNG
png1 = PyToolsgr.New("PNG",(100,100),position=(1,0),texture="image.png")

# 创建文本
t1 = PyToolsgr.New("Text",(100,100),position=(0,1),text="Hello World",font_size=30)

# 创建玩家
p1 = PyToolsgr.New("Player",(100,100),position=(-1,0),texture="player.png")

4. 显示/隐藏对象

PyToolsgr.look(p1) # 显示单个对象
PyToolsgr.look_n(p1) # 隐藏单个对象
PyToolsgr.look_a([p1,b1]) # 显示多个对象
PyToolsgr.look_n_a([p1,b1]) # 隐藏多个对象

5. 设置对象位置

PyToolsgr.set_pos(p1,(100,100)) # 设置单个对象位置
PyToolsgr.set_pos_a([p1,b1],(100,100)) # 设置多个对象位置

完整示例代码：

from PyToolsgr import *
PyToolsgr.OS('Windows') # 或MacOS , Linux

x = (1080,720) # 窗口大小
all = True # 是否全屏
title = 'PyToolsgr' # 窗口标题
y = True # 是否可以调整窗口大小
fps = 60 # 最大帧率
fpsx = True # 是否显示帧率
phy = True # 是否开启物理引擎
mode = '2d' # 2d或3d

game = PyToolsgr.game(x,all,title,y,fps,fpsx,phy,mode)  

PyToolsgr.beijing((0,0,0)) # 背景颜色

b1 = PyToolsgr.New("Block",(100,100),position=(0,0),color=color.red,phy_=(100,100))
png1 = PyToolsgr.New("PNG",(100,100),position=(1,0))
t1 = PyToolsgr.New("Text",(100,100),position=(0,1),text="Hello World",font_size=30)
p1 = PyToolsgr.New("Player",(100,100),position=(-1,0),texture="white_cube")

PyToolsgr.look(p1) # 显示
PyToolsgr.look_n(p1) # 隐藏
PyToolsgr.look_a([p1,b1]) # 显示多个对象
PyToolsgr.look_n_a([p1,b1]) # 隐藏多个对象
PyToolsgr.set_pos(p1,(100,100)) # 设置位置
PyToolsgr.set_pos_a([p1,b1],(200,200)) # 设置多个对象位置

game.run()

许可证

cfk 使用 MIT 许可证，详情请查看 LICENSE 文件。

鸣谢

• Ursina - 基础游戏引擎
• Python - 编程语言

联系方式

• 项目主页: https://github.com/l-love-china/PyToolsgr
• PyPI: https://pypi.org/project/PyToolsgr/