Pengantar ke Skrip Modul | Dokumentasi

Saat proyek menjadi kompleks, menjadi penting untuk berpikir bagaimana skrip diatur. Praktik manajemen yang baik dapat memastikan bahwa kode tidak duplikasi di antara skrip, atau menjadi sulit untuk dikelola.

Cara yang lebih baik untuk mengatur dan menggunakan kembali kode adalah dengan naskah modul , jenis script yang unik yang menyimpan set fungsi dan variabel yang dirancang untuk memenuhi tujuan bersama, seperti mengelola uang pemain atau musuh. Kode dalam naskah modul dapat digunakan oleh script lain. Dengan demikian, Anda dapat memanggil fungsi yang s

Dengan menyimpan kode yang sering digunakan di script modul, membuat perawatan dan organisasi kode lebih mudah karena perubahan hanya perlu dibuat ke satu script modul, bukan menyetujui beberapa script.

Skrip normal seharusnya digunakan untuk elemen berdiri sendiri dari game, seperti menyentuh pengambilan, sementara script modul berguna untuk menyimpan kode yang dapat diulang oleh beberapa skrip independen, seperti menghadiahkan poin.

Pengantar Kode Modul

Script modul sebenarnya adalah objek terpisah mereka sendiri dibandingkan dengan objek skrip. Di Roblox, script modul dapat ditandai dengan ujung ungu ikon.

Membuat Skrip Modul

ModuleScripts biasanya ditempatkan di ServerScriptService ketika digunakan oleh skrip sisi server dan ReplicatedStorage ketika digunakan oleh lokasi lokal klien (seperti interaksi GUI).

Buat ModuleScript di ServerStorage .

Struktur Skrip Modul

Ketika dibuat, setiap naskah modul dimulai dengan kode di bawah ini:


local Module = {}

return Module

Baris local Module = {} menciptakan tabel, atau wadah kode, di mana fungsi dan variabel modul dapat disimpan. Tabel ini harus diubah ke tujuan modul, seperti RewardManager atau ParticleController . Berbeda dengan variabel l


local RewardManager = {}

return RewardManager

Jadi, script lain dapat menggunakan fungsi non-lokal atau variabel modul, setiap modul berakhir dengan kembalian MyModule. Setiap kali script lain mencoba mendapatkan kode dari modul, kembalian memungkinkan script itu mengakses kode yang disimpan di tabel modul.

Menambahkan ke Skrip Modul

Untuk menambahkan fungsi atau variabel ke modul yang dapat digunakan dalam script lain, tulis nama modul tabel, diikuti oleh dot, dan nama fungsi atau variabel, seperti dalam TestModule.myVariable . Menggunakan operator dot adalah cara lain untuk menambahkan kode ke tabel, memungkinkan script lain untuk mengakses kode itu setiap kali tabel modul dikembalikan.


local TestModule = {}

-- Menambahkan variabel ke tabel 'TestModule'
TestModule.myVariable = 100

-- Menambahkan fungsi ke tabel 'TestModule'
function TestModule.doTask(player)
	-- kodepengganti
end

return TestModule

Apa pun yang ditambahkan ke tabel modul harus ditulis antara local MyModule = {} dan return MyModule, atau kode mungkin menciptakan kesalahan.

Pemetaan dalam Modul Skrip

Untuk fungsi modul atau variabel yang akan digunakan dalam skrip luar, jangan mengetik local .

Mengetik local di depan variabel dan fungsi berarti mereka hanya dapat digunakan oleh skrip itu. Sementara ini adalah praktik yang baik untuk kebanyakan script untuk mengurangi kesalahan dan masalah, Anda tidak dapat membuat fungsi dan variabel modul lokal.

Setiap kode yang digunakan hanya oleh naskah module itu harus masih mencakup local . kejadian, kode di bawah ini meng包括 variabel lokal difficultyModifier, yang hanya dapat digunakan dalam naskah module itu, dan fungsi 1> GCoinReward()1>, yang dapat digunakan dalam skrip di luar modul


local RewardManager = {}

-- Hanya dapat digunakan dalam naskah modul
local rewardCoins = 50

-- Hanya dapat digunakan dalam naskah modul
local difficultyModifier = {
	easy = 0.5,
	normal = 1,
	hard = 2
}

-- Dapat digunakan dalam skrip lain
function RewardManager.getCoinReward(difficulty)
	local coins = difficultyModifier[difficulty] * rewardCoins
	return coins
end

return RewardManager

Menggunakan Modul dalam Script Lain

Secara default, naskah modul tidak dapat mengeksekusi kode — itu perlu dimuat dalam naskah lain menggunakan kata kunci require(). Fungsi require() menerima satu argumen, lokasi naskah script di Explorer.

Untuk menggunakan modul, dalam naskah terpisah, tetapkan variabel sama dengan require(moduleScript) .


local MyModule = require(ServerStorage.ModuleScript)

Sekarang, variabel MyModule mengandung tabel modul yang dibuat dalam skrip modul tersebut. Untuk menggunakan fungsi dan variabel dari tabel ini, ketik nama variabel, diikuti oleh dot, dan nama persis apa yang akan digunakan dalam modul script tersebut, seperti MyModule.myFunction() . Ketika script berjalan dan mencapai


local MyModule = require(ServerStorage.ModuleScript)

MyModule.myFunction()

Contoh RewardManager

ModuleScript - RewardManager
local RewardManager = {}

-- Hanya dapat digunakan dalam naskah modul
local rewardCoins = 50

-- Hanya dapat digunakan dalam naskah modul
local difficultyModifier = {
 easy = 0.5,
 normal = 1,
 hard = 2
}

-- Dapat digunakan dalam skrip lain
function RewardManager.getCoinReward(difficulty)
 local coins = difficultyModifier[difficulty] * rewardCoins
 return coins
end

return RewardManager

Skrip - TreasureChestScript
local ServerStorage = game:GetService("ServerStorage")

-- Muat naskah modul
local RewardManager = require(ServerStorage.RewardManager)

--Memanggil fungsi dari naskah modul
local coins = RewardManager.getCoinReward("easy")
print("Should award " .. coins .. " coins")

Jika Anda berada di script lain, pastikan bahwa fungsi atau variabel modul ditulis dengan benar persis sama seperti yang ditemukan di module tersebut. Untuk membantu, Anda dapat menyalin nama fungsi atau variabel modul dari module dan kemudian hanya paste itu di script normal di mana itu akan digunakan.

Umum Troubleshooting

Beberapa tips di sini mengatasi masalah umum saat bekerja dengan skrip modul. Ingatlah bahwa modul skrip dapat menjadi topik yang rumit dengan lebih banyak nuansa. Untuk lebih banyak rincian, lihat panduan teknis ini tentang Module Scripts . Masalah: Dapatkan pesan kesalahan termasuk: "Infinite yield possible" atau "not a valid member".

Periksa tata bahasa modul script di mana itu dimuat. require() harus mencakup jalan dan tata bahasa modul script, yang mungkin bernama berbeda dari tabel modul. Masalah: Dapatkan pesan kesalahan termasuk: "attempt to index global".
Dalam setiap skrip menggunakan modul skrip, pastikan itu dimuat menggunakan fungsi require(). Jika tidak, skrip itu tidak dapat menggunakan fungsi dan variabel dari modul skrip.

Sintesis

Skrip modul di Roblox adalah metode yang digunakan untuk mengatur dan menggunakan kembali kode. Skrip modul sering disimpan di ServerStorage (atau ReplicatedStorage untuk interaksi klien-based). Dari sana, skrip lain dapat memanggil fungsi dan variabel yang disimpan dalam modul script tersebut.

kejadian, satu game mungkin memberikan poin kepada pemain untuk mengumpulkan objek. Modul skrip dapat menangani kode untuk memberikan poin. Kemudian, skrip untuk berbagai jenis objek hanya dapat menangani fungsi modul. Ini mengurangi kebutuhan untuk menggunakan kode di antara skrip, membuat kode lebih mudah dimengerti dan dipertahankan.