Script throws an error immediately on run
Script throws an error immediately on run
If your script produces an error the moment you run it, the most common causes are missing variables, uninitialized values, or
nil references that the script expected to be set up beforehand.Steps to try:- Read the full error message carefully — it usually includes the file name and line number where the problem occurred.
- Check that all required variables are defined before the script runs.
- Look for any
nilvalue warnings, which often indicate that an object, service, or dependency wasn’t found. - Confirm that any external files, modules, or assets the script depends on are present and correctly named.
Script runs but doesn't do what I expected
Script runs but doesn't do what I expected
If the script executes without errors but the behavior doesn’t match what you had in mind, the first thing to do is revisit your original request description.Steps to try:
- Compare the script’s behavior against the exact wording of your request. Scripting is implemented literally — if something was ambiguous in your description, it may have been interpreted differently than you intended.
- Make a list of specific behaviors that are incorrect or missing, using clear, concrete terms (e.g., “the enemy should stop moving when health reaches zero” rather than “it doesn’t work right”).
- Submit a revision request with your list of discrepancies. The more precisely you describe the gap between expected and actual behavior, the faster we can address it.
Roblox script works in Studio but not in the live game
Roblox script works in Studio but not in the live game
This is one of the most common Roblox-specific issues and almost always comes down to the server/client boundary or FilteringEnabled behavior.Steps to try:
- Determine whether your script runs on the server (Script), client (LocalScript), or both. Actions performed on the client are not automatically replicated to the server.
- Check for any operations that require server authority — such as modifying character health, moving parts, or changing values in
workspace— being run from a LocalScript without usingRemoteEventorRemoteFunctionto communicate with the server. - Review the output window in Studio while running a Play Solo or Team Test session to see if additional errors appear in the live context.
- If the issue involves player data or replication, confirm that your
RemoteEventandRemoteFunctioninstances exist inReplicatedStorageand are referenced correctly on both sides.
Python script fails with ModuleNotFoundError
Python script fails with ModuleNotFoundError
A
ModuleNotFoundError means Python can’t locate a package that the script depends on. This is an environment issue, not a problem with the script itself.Steps to try:- Install the missing package using pip. For example, if the error says
No module named 'requests', run: - If you’re using a virtual environment, make sure it’s activated before running the script or installing packages.
- If multiple packages are missing, check whether the script came with a
requirements.txtfile. If so, install everything at once with: - Confirm that you’re running the script with the same Python interpreter that has your packages installed — mixing Python versions (e.g.,
pythonvs.python3) is a common cause of this problem.
Script runs slowly or causes lag
Script runs slowly or causes lag
Performance issues can have several causes, including expensive operations running every frame, redundant loops, inefficient data lookups, or unoptimized rendering logic.Steps to try:
- Check whether the slow behavior started immediately or developed over time. Gradual slowdowns often point to a memory leak or an accumulating loop.
- In Roblox, use the MicroProfiler (
Ctrl+F6) to identify which operations are consuming the most time per frame. - In Python, consider using the built-in
cProfilemodule to profile your script and identify bottlenecks. - Avoid running expensive computations inside tight loops or
RunService.Heartbeat/RenderSteppedcallbacks when they don’t need to run every tick.
I modified the script and now it's broken
I modified the script and now it's broken
If you made changes to the delivered script and it stopped working, the fastest path to a resolution is to isolate exactly what changed.Steps to try:
- Revert to the original delivered version of the script. This confirms whether the issue is with your modification or something else in your environment.
- Once you’ve confirmed the original works, re-apply your changes one at a time, testing after each change to pinpoint which modification caused the problem.
- Note down exactly what you changed — the line(s) you edited, added, or removed — before contacting us.
Contact Us
Couldn’t resolve your issue? Get in touch and we’ll help you sort it out.
Revisions
Learn how to submit a revision request if your script needs adjustments.