Skip to content

README.th.md

Latest commit

 

History

History
356 lines (267 loc) · 16.6 KB

README.th.md

File metadata and controls

356 lines (267 loc) · 16.6 KB
Raw
FastCast2 Cover

ความต่อเนื่องที่ไม่ใช่อย่างเป็นทางการของ FastCast สำหรับ Roblox

เวอร์ชันที่ปรับปรุงแล้วของ FastCast พร้อม Parallel luau, Extensions เพิ่มเติม, และ statically typed.
ไลบรารีโปรเจกไทล์ที่ทรงพลังและทันสมัย

FastCast2 เป็น ไลบรารีโปรเจกไทล์ของ Roblox ออกแบบมาเพื่อจำลองหลายพันโปรเจกไทล์ โดยไม่ต้องพึ่งพาการจำลองฟิสิกส์
เนื่องจาก FastCast ไม่ได้รับการบำรุงรักษาอย่างแข็งขันโดย EtiTheSpirit ที่เก็บนี้จึงดำเนินโครงการต่อไปด้วยการปรับปรุงและปรับตัว


ข้อดีของการใช้ FastCast2

  • ปรับแต่งได้สูง
  • ไลบรารีโปรเจกไทล์อเนกประสงค์
  • รองรับ Parallel luau
  • ใช้งานและรวมเข้าได้ง่าย
  • รองรับ Raycast และ Blockcast, Spherecast
  • รองรับ BulkMoveTo/Motor6D
  • มี castVisualization ในตัว
  • มี ObjectCache ในตัว
  • มีการควบคุม HighFidelitySegment ในตัว
  • ออกแบบที่ยืดหยุ่นและขยายได้
  • ปรับปรุงผลผลิตการพัฒนา
  • ประสิทธิภาพสูง
  • ฟรีทั้งหมด

FastCast2 เป็นโครงการโอเพนซอร์ส และการมีส่วนร่วมจากชุมชนได้รับการต้อนรับ
อ่านเพิ่มเติมใน FastCast2 devforum

คู่มือการติดตั้ง

  1. ไปที่ Releases และติดตั้งไฟล์ .rbxm จากรุ่นล่าสุด
  2. เปิด Roblox Studio และเปิดโครงการใดๆ
  3. ไปที่ File → Import Roblox Model และนำเข้าไฟล์ .rbxm
  4. หลังจากนำเข้า FastCast2 จะปรากฏในพื้นที่ทำงานของคุณ
  5. ลาก FastCast2 ไปที่ ReplicatedStorage
  6. สร้างส่วน (Part) และตั้งค่า:
    • ขนาดเป็น 1, 1, 1
    • CanTouch = false
    • CanCollide = false
    • CanQuery = false
  7. เสร็จแล้ว — คุณพร้อมที่จะใช้ FastCast2

ติดตั้งด้วย Rojo

  1. ติดตั้ง Rojo CLI สำหรับระบบของคุณ
  2. โคลนที่เก็บนี้:
   git clone https://github.com/weenachuangkud/FastCast2.git
   cd FastCast2
   rm -rf .git
  1. ซิงค์กับ Roblox:
   rojo sync -o <place-name>

หรือให้บริการแบบสดด้วย:

   rojo serve

จากนั้นเชื่อมต่อใน Roblox Studio ผ่าน Studio → Plugins → Rojo

ตัวอย่างโค้ด

ยิงโปรเจกไทล์จากหัวของคุณ (โหมดอนุกรม - ง่ายกว่า, เธรดหลัก):

-- บริการ (Services)
local Rep = game:GetService("ReplicatedStorage")
local Players = game:GetService("Players")

-- ต้องการ (Requires)
local FastCast2 = require(Rep:WaitForChild("FastCast2"))
local FastCastEnums = require(Rep:WaitForChild("FastCast2"):WaitForChild("FastCastEnums"))

-- ค่าคงที่
local SPEED = 500

-- ตัวแปร
local player = Players.LocalPlayer
local character = player.Character or player.CharacterAdded:Wait()
local Head = character:WaitForChild("Head")
local Mouse = player:GetMouse()

local ProjectileContainer = workspace:WaitForChild("Projectiles")
local ProjectileTemplate = Rep:WaitForChild("Projectile")

-- พารามิเตอร์การแคสต์ (CastParams)
local CastParams = RaycastParams.new()
CastParams.FilterDescendantsInstances = {character}
CastParams.FilterType = Enum.RaycastFilterType.Exclude
CastParams.IgnoreWater = true

-- พฤติกรรม (Behavior) - FastCastBehavior
local behavior = FastCast2.newBehavior()
behavior.MaxDistance = 1000
behavior.RaycastParams = CastParams
behavior.HighFidelityBehavior = FastCastEnums.HighFidelityBehavior.Default
behavior.HighFidelitySegmentSize = 1
behavior.Acceleration = Vector3.new(0, -workspace.Gravity/2.3, 0)
behavior.CosmeticBulletContainer = ProjectileContainer
behavior.CosmeticBulletTemplate = ProjectileTemplate


-- โปรแกรมทำการแคสต์แบบอนุกรม (Serial Caster) - ทำงานบนเธรดหลัก ง่ายกว่า
local Caster = FastCast2.new()
Caster:Init("BulkMoveTo", false) -- โหมดการเคลื่อนไหว, ใช้ ObjectCache

-- เหตุการณ์ (Events) - สามารถตั้งค่าได้ก่อน Init
Caster.Hit = function(cast, result, velocity, bullet)
	print("ตี: " .. result.Instance.Name)
end

-- ยิง
local function fire()
	local origin = Head.Position
	local direction = (Mouse.Hit.Position - origin).Unit
	Caster:RaycastFire(origin, direction, SPEED, behavior)
end

-- อินพุต
game:GetService("UserInputService").InputBegan:Connect(function(input, gameProcessed)
	if gameProcessed then return end
	if input.UserInputType == Enum.UserInputType.MouseButton1 then
		fire()
	end
end)

Blockcast & Spherecast

สลับ RaycastFire ไปยัง BlockcastFire หรือ SpherecastFire เพื่อเปลี่ยนประเภทการแคสต์:

-- Blockcast: ส่ง Vector3 ขนาดหลังจากจุดกำเนิด
Caster:BlockcastFire(origin, Vector3.new(2, 4, 2), direction, SPEED, behavior)

-- Spherecast: ส่งหมายเลขรัศมีหลังจากจุดกำเนิด
Caster:SpherecastFire(origin, 3, direction, SPEED, behavior)

ObjectCache (การรีไซเคิลกระสุน)

ObjectCache นำอินสแตนซ์กระสุนเครื่องแบบกลับมาใช้ใหม่แทนการสร้าง/ลบเมื่อทำการยิง:

local Caster = FastCast2.new()
Caster:Init("BulkMoveTo", true, ProjectileTemplate, 500, workspace)
--                                    ^template   ^size  ^holder

แคชจัดสรร 500 ส่วนล่วงหน้าตามค่าเริ่มต้น, ขยายโดยอัตโนมัติเมื่อหมด, และย้ายส่วนที่ตกลงมาไปยัง CFrame ห่างไกล ผ่าน BulkMoveTo — ไม่มีค่าใช้จ่ายในการสร้าง/ลบอินสแตนซ์

โหมดขนาน (ประสิทธิภาพสูงพร้อม VM หลายตัว)

local Caster = FastCast2.newParallel()
Caster:Init(
	4,                 -- จำนวนคนงาน (numWorkers)
	workspace,         -- ที่อยู่ของโฟลเดอร์ VM
	"FastCastVMs",     -- ชื่อโฟลเดอร์ VM
	workspace,         -- ที่อยู่ของคอนเทนเนอร์
	"VMContainer",     -- ชื่อคอนเทนเนอร์
	"VM",              -- ชื่อ VM
	"BulkMoveTo",      -- โหมดการเคลื่อนไหว
	nil,               -- FastCastEventsModule (ไม่บังคับ)
	false              -- ใช้ ObjectCache
)

-- เหตุการณ์ทำงานเหมือนกับโหมดอนุกรม
Caster.Hit = function(cast, result, velocity, bullet)
	print("ตี: " .. result.Instance.Name)
end

--[[
	-- ยกเว้น:
	-- Caster.CanPierce
	--> คุณจะต้องใช้ FastCastEventsModule สำหรับสิ่งนั้น
]]

-- ยิงเหมือนกับโหมดอนุกรม
Caster:RaycastFire(origin, direction, SPEED, behavior)
Caster:BlockcastFire(origin, Vector3.new(2, 4, 2), direction, SPEED, behavior)
Caster:SpherecastFire(origin, 3, direction, SPEED, behavior)

วิธีการตั้งค่า FastCastEventsModule

-- บริการ (Services)
local Rep = game:GetService("ReplicatedStorage")

-- โมดูล (Modules)

local FastCast2 = Rep:WaitForChild("FastCast2")

-- ต้องการ (Requires)
local TypeDef = require(FastCast2:WaitForChild("TypeDefinitions"))

-- โมดูล

local module: TypeDef.FastCastEvents = {}

local debounce = false
local debounce_time = 0.2

module.LengthChanged = function(cast : TypeDef.ActiveCastData)
	if not debounce then
		debounce = true
		print("ทดสอบ OnLengthChanged")
		task.delay(debounce_time, function()
			debounce = false
		end)
	end
end

module.CastFire = function()
	print("ยิงแคสต์!")
end

module.CastTerminating = function()
	print("แคสต์กำลังจะสิ้นสุด!")
end

module.Hit = function()
	print("ตี!")
end

module.CanPierce = function(cast : TypeDef.ActiveCastData, resultOfCast : RaycastResult, segmentVelocity, CosmeticBulletObject)
	local CanPierce = false
	if resultOfCast.Instance:GetAttribute("CanPierce") == true then
		CanPierce = true
	end
	print(CanPierce)
	return CanPierce
end

module.Pierced = function()
	print("เจาะทะลุ!")
end


return module

ลงทะเบียนไว้กับ parallel caster ของคุณหลังจาก Init:

Caster:SetFastCastEventsModule(pathTo.FastCastEventsModule)

หมายเหตุ: SetFastCastEventsModule มีเฉพาะใน parallel casters เท่านั้น ในโหมดอนุกรม ให้ตั้งค่าตัวจัดการเหตุการณ์โดยตรงบน caster (เช่น Caster.Hit = function(...))

โหมดการเคลื่อนไหว Motor6D

โหมด Motor6D ใช้ Motor6D.Transform เพื่อประสิทธิภาพที่ดีขึ้นแทน BulkMoveTo:

local Caster = FastCast2.new()
Caster:Init("Motor6D", false) -- โหมดการเคลื่อนไหว = "Motor6D"

แคสต์ที่ใช้งานอยู่ทั้งหมดจะได้รับการเชื่อมต่อ Motor6D โดยอัตโนมัติเมื่อลงทะเบียนและตัดการเชื่อมต่อเมื่อทำความสะอาด คุณสามารถสลับโหมดเมื่อต้องการ:

Caster:SetMovementModeEnabled(true, "Motor6D")   -- เปิดใช้ Motor6D
Caster:SetMovementModeEnabled(true, "BulkMoveTo") -- สลับกลับ

การจัดการแคสต์

ปรับเปลี่ยนแคสต์ที่ใช้งานอยู่เมื่อต้องการโดยใช้เมธอด FastCast แบบคงที่:

-- อ่านสถานะ
local pos = FastCast2:GetPositionCast(cast)
local vel = FastCast2:GetVelocityCast(cast)
local accel = FastCast2:GetAccelerationCast(cast)

-- ปรับเปลี่ยนสถานะ (โดยอัตโนมัติจะปรับเส้นทางใหม่)
FastCast2:SetPositionCast(cast, Vector3.new(0, 50, 0))
FastCast2:SetVelocityCast(cast, Vector3.new(0, 100, 0))
FastCast2:SetAccelerationCast(cast, Vector3.new(0, -workspace.Gravity, 0))

-- การเปลี่ยนแปลงสัมพัทธ์
FastCast2:AddPositionCast(cast, Vector3.new(0, 10, 0))
FastCast2:AddVelocityCast(cast, Vector3.new(0, 20, 0))
FastCast2:AddAccelerationCast(cast, Vector3.new(0, -50, 0))

-- สิ้นสุดแคสต์ก่อนเวลาอันควร (ไฟร์ CastTerminating และทำความสะอาด)
FastCast2:TerminateCast(cast)

เคล็ดลับ: ในโหมดขนาน โทร Caster:SyncChangesToCast(cast) หลังจากปรับเปลี่ยนเพื่อดันการเปลี่ยนแปลงเข้าสู่เวิร์กเกอร์ VM

-> เริ่มต้นใช้ docs FastCast2

คนที่อยู่เบื้องหลัง FastCast2 (ผู้มีส่วนร่วม)

  • CK06: นักพัฒนาหลัก ผู้บำรุงรักษา ออกแบบกราฟิก
  • Naymmmm: ช่วยทํา docs เเละ CI ให้, เพิ่ม Rojo, เพิ่ม wally, เพิ่ม Github pages(Moonwave)
  • EtiTheSpirit: นักพัฒนาต้นฉบับ
  • Per2iako: แก้ ActivesRef ถูกเขียนทับ (BaseParallel, ParallelSimulation)

ขอบคุณพิเศษ

ขอบคุณอย่างสูงต่อคนต่างๆ ต่อไปนี้จาก Suphi Kaner Discord Server:

  • @avibah — สำหรับการช่วยเหลือผมในการสร้าง VMDispatcher
  • @ace9b472eeec4f53ba9e8d91bo87c636 — สำหรับคำแนะนำ ข้อเสนอแนะ และความคิดเห็น
  • @23sinek345 — สำหรับการตรวจสอบโค้ด การสนทนาเกี่ยวกับเกณฑ์มาตรฐาน และการแนะนำการปรับปรุง

และขอขอบคุณทุกคนในเซิร์ฟเวอร์ที่ให้ความช่วยเหลือตลอดมาด้วย

ข้อเสนอแนะของชุมชนมีบทบาทสำคัญในการพัฒนาของ FastCast2 ความคิดเห็น การสนทนา และแหล่งที่มาของแรงจูงใจจำนวนมากมาจากการสนทนาภายในเซิร์ฟเวอร์ Discord ของ Suphi Kaner, FastCast2 คงจะไม่เกิดขึ้นถ้าไม่มีการมีส่วนร่วม ข้อเสนอแนะ และการสนับสนุนของชุมชน

การพึ่งพา(Dependency)