2DBalls Studio — Quản lí Weapon

Đang tải danh sách weapon...

Trong TBalls Engine v5.3, mọi vũ khí và đạn đều là Python class thuần tuý, kế thừa từ Weapon hoặc Projectile:

🎯 Nguyên Tắc Cốt Lõi:

Kế thừa trực tiếp: class MyWeapon(Weapon): nằm tại thư mục Server/Weapons/.
Vật thể bay: class MyBullet(Projectile): nằm tại thư mục Server/Projectiles/.
Không còn cú pháp DSL .sbw cũ: Viết code Python 100%, tận dụng đầy đủ OOP, toán học, timer và logic tuỳ biến.
Gây sát thương an toàn: Sử dụng self.deal_damage(target, dmg) và self.deal_aoe_damage(pos, radius, dmg). Engine tự động làm tròn số nguyên an toàn và ngăn chặn double-hit cùng frame.

Callback Method	Đối tượng	Thời điểm kích hoạt & Chức năng
`on_init(self)`	Weapon / Projectile	Khởi tạo biến riêng, bộ đếm cooldown, danh sách trạng thái ban đầu.
`on_equip(self, player)`	Weapon	Kích hoạt ngay khi người chơi nhặt và trang bị vũ khí.
`on_drop(self, player)`	Weapon	Kích hoạt khi chủ nhân rơi vũ khí hoặc đổi sang vũ khí khác.
`on_tick(self, dt)`	Weapon / Projectile	Chạy mỗi khung hình game tick (dt tính bằng giây). Dùng để đếm cooldown, tăng tốc vật lý.
`on_collision(self, other, other_layer)`	Weapon	Kích hoạt khi vũ khí cận chiến chạm player, weapon hoặc wall.
`on_hit(self, target)`	Projectile	Kích hoạt khi đạn bắn trúng kẻ địch. Mặc định gọi super().on_hit(target).
`on_wall_hit(self, wall, normal)`	Projectile	Kích hoạt khi đạn chạm tường (xử lý nảy, hiệu ứng tia lửa, âm thanh).
`on_projectile_hit(self, target, projectile)`	Weapon	Kích hoạt trên Weapon khi viên đạn do nó bắn ra trúng mục tiêu (dùng nâng cấp chỉ số).

Thuộc tính	Kiểu dữ liệu	Mặc định	Ý nghĩa & Mô tả
`name`	str	Tên file	Tên định danh duy nhất của vũ khí.
`shape`	str	"square"	Hình dạng va chạm: `"square"` hoặc `"circle"`.
`width, height`	float	25, 160	Kích thước hình chữ nhật khi shape là "square".
`radius`	float	30	Bán kính khi shape là "circle".
`pickupable`	bool	True	Có thể được người chơi nhặt trên sàn đấu hay không.
`drop`	bool	False	Khi chủ nhân chết, vũ khí có rơi ra sàn đấu cho người khác nhặt hay không.
`motion_type`	str	"orbit"	Kiểu di chuyển: `"orbit"` (quay vòng quanh chủ) hoặc `"aim"` (tự ngắm).
`orbit_speed`	float	5.0	Tốc độ quay quỹ đạo (rad/giây). Dấu âm/dương quyết định chiều quay.
`aim_speed`	float	15.0	Tốc độ xoay nòng bám đuổi mục tiêu (rad/giây).
`damage`	int / float	10	Lượng sát thương cơ bản gây ra cho mục tiêu.
`add_damage`	int / float	0	Lượng sát thương cộng thêm sau mỗi lần chém trúng.
`cooldown`	float	0.5	Khoảng thời gian giãn cách giữa các đợt tấn công / bắn đạn (giây).

Hàm gọi	Tham số	Công dụng
`self.deal_damage(target, amount)`	target, amount	Gây sát thương lên đối thủ, an toàn làm tròn và chống double-hit.
`self.deal_aoe_damage(center, radius, amount)`	center, radius, amount	Gây sát thương diện rộng nổ lan cho tất cả kẻ địch trong bán kính.
`self.fire(projectile, angle=0.0)`	projectile, angle	Bắn một viên đạn bay ra khỏi mũi vũ khí theo góc lệch chỉ định.
`self.reverse_direction()`	không	Đảo ngược chiều xoay quỹ đạo vũ khí cận chiến khi va chạm.
`self.knockback(target, force)`	target, force	Đẩy lùi mục tiêu theo hướng véc-tơ va chạm với lực chỉ định.
`self.heal_owner(amount)`	amount	Hồi phục máu cho chủ nhân đang trang bị vũ khí.
`self.spawn_effect(name, **kwargs)`	name, **kwargs	Tạo hiệu ứng hình ảnh VFX: `"spark"`, `"shockwave"`.