Easytime

Step-by-step installation guide, common issues & solutions, code snippets, error codes, config previews, locales previews and changelogs; all in 1 easily accessible place.

Download Here

FiveM Forums Post

YouTube Showcase Video

Translate

• Click here to translate this page.

• How do I change language?

---

---

INSTALLATION GUIDE

Step 1 - Download

1. Download your resource from GitHub.

2. Unzip the cd_easytime.zip folder and place this folder in your server's resource folder.

3. Add the resource to your server start config (server.cfg). Make sure cd_easytime is listed below your framework resource e.g., es_extended, not above it.

ensure es_extended
ensure cd_easytime

---

---

Step 2 - Fxmanifest

Depending on your framework and dependencies, you may need to make some changes inside [cd_easytime/fxmanifest.lua]. We have simplified this process by commenting on the lines that you may need to modify.

---

Step 3 - Configure Resource

You must read all configurable options inside [cd_easytime/configs/config.lua] and adjust them to fit your server's needs. Please pay attention to the "commented out help text" at the end of each line to understand the purpose of each config option.

The most important sections are those under the Framework and Important categories at the top of the config.lua. Everything else is optional.

---

Step 4 - How Do I Use It?

• Open the User Interface:

  • To access the UI, use the command: /easytime.

• Permissions:

  • The script comes pre-configured to work with several frameworks, including ESX, QBCore, QBox, vRP, ACE permissions, and specific user identifiers for flexible permission management.

  • To set up the desired permission groups:

    1. Open the [cd_easytime/configs/config.lua].

    2. Find the line that says Config.Command.

    3. Add the permission groups you want to allow access to the UI.

---

---

COMMON ISSUES

Please check out our Troubleshooting Guide before contacting our support.

🔔 Folder Name Make sure the name of the folder is cd_easytime.

🔔 Encrypted Files Do not edit the encrypted files in any way.

Screen Flickering?

eg., if your screen is flickering while using cd_easytime.

✔️ This issue is caused by having multiple time or weather synchronization scripts running simultaneously, which conflict with each other (e.g., vSync or vMenu). To resolve this, please disable the other time or weather synchronization script that is causing the conflict.

Permission Checks Error?

eg., if you are having errors related to the permission checks for the /easytime command.

✔️ If you are experiencing errors related to permission checks for the /easytime command, ensure that the appropriate permission groups are correctly configured in the Config.Command.Perms in the config.lua file. Or check the PermissionsCheck function in the server.lua.

Footprints?

eg., if players are seeing footprints when the weather is not snowing (e.g., during summer or clear weather).

✔️ This is due to a conflict with a script you are using called fanox-hunting. To resolve this issue, remove the following two lines from the client-side of the script:

if Config.EnableFootprints then
    SetForcePedFootstepsTracks(true)
end

---

---

CHANGELOG

Files Changed

Not every update requires replacing the entire folder, as we understand it’s a hassle to redo configs for each update.

• All Files: Delete the old cd_easytime folder, download the latest version, reconfigure the configs folder, and restart your server.

• All Files Except config.lua: Follow the steps above, but first back up your existing config.lua file. After downloading, replace the new config.lua with your backup.

• Specific Files: Simply copy and paste the specific updated files over the old ones, then restart your server.

Update Type

Occasionally, updates are mandatory due to changes like authentication updates, which make older versions obsolete.

• Mandatory - You must update to the latest version; older versions will stop working.

• Optional - Updating is your choice, but we don’t support outdated versions.

Skipping Updates

If you’ve skipped previous updates, it’s best to update all files to ensure compatibility. For example, if you're on v4.0.1, skipped v4.0.2, and now want to update to v4.0.3, use the "All Files" method for safety.

v1.1.4

20/03/2021 - 22/03/2021

v1.1.4 - v1.1.7

Files Changed:

• All files

• Specific Files

Changelog:

Add

• Added a version check to ensure you stay updated with the progress.

Edit

• Reworked the FORCED time changes so the changes are a lot smother.

• Reworked the natural weather changes so the changes are a lot smoother and barely noticeable.

• Reworded the config to be a bit more user friendly.

• Added a wait before syncing a players time and weather to ensure stability.

Fix

• Fixed a typo in causing the time cycle to speed up.

• Fixed a small issue which would cause the weather to change to clear Instantly when entering a shell due to the pervious updates.

• File clean-up, removed the old client file which was renamed.

• Fixed a typo in the client.lua causing a error.

v1.2.0

15/05/2021 - 29/06/2021

v1.2.0 - v1.2.1

Files Changed:

• All files

• Specific Files

Changelog:

Add

• Added the ability to toggle the instant time and weather change on the in game UI instead of it being a config option, meaning you can choose whether you want to instantly change the time or make the time change slowly so its barely noticeable to players in game.

• Added a new config option to allow you to walk around while the UI is open.

• Added a fail safe check to make sure the time and weather is synced when a player joins the server.

• Added drag and drop compatibility for qbus and ace permissions (read Step 1 for more information).

• The settings now automatically save when the script is restarted.

Edit

• Now when you click the "Save Settings" button on the in game UI, your chosen settings will be saved to the settings.txt file and applied in game, then the UI will close. (previously you needed to open the UI, choose your settings, click the "Change" button, reopen the UI and then click the "Save Settings" button).

• Edited the Config.NUI_keepinput to disable mouse movement and punching/firing weapons while the UI is open.

Fix

• Fixed time not syncing for new players when the FreezeTime option is enabled.

v1.3.0

18/12/2021

Files Changed:

• All files

• Specific Files

Changelog:

Add

• Tsunami warning (pre-restart warning): This feature adds visual and sound effects to warn players that a server restart is about to happen while keeping it in-character. It changes the weather to Halloween, then shortly after it enables a city wide blackout and plays a tsunami warning alert sound just before the server restart.

• Added pre-set permissions for each framework config option.

Edit

• Rewrote parts of the script as some were outdated.

Fix

• Fixed issues with the weather not being synced on ESX/QBCore servers.

• Other minor bug fixes.

v1.3.1

22/12/2021

Files Changed:

• All files

• Specific Files

fxmanifest.lua
server/server.lua

Changelog:

Fix

• Reverted a change that caused the tsunami warning to have issues.

• Implemented a fix from a previous GitHub pull request to fix an issue with dynamic weather.

v1.3.3

20/04/2022

Files Changed:

• All files

• Specific Files

Changelog:

Add

• Added a option to use a identifier based permission system (steam/license).

• Added a new config option to allow vehicles lights to stay turned on during blackouts.

Edit

• Updated the blackout native.

• Removed unused framework job code.

Fix

• Fixed QBCore perms.

• Fixed aceperms.

v1.3.4

28/04/2022

Files Changed:

• All files

• Specific Files

Changelog:

Add

• Added drag-and-drop compatibility for cd_easytime to be used on QBCore servers and in replacement for vSync, meaning; dependencies don't need to be removed and events don't need changing when switching from QBCore or vSync to cd_easytime.

Fix

• Fixed the time and weather not changing when clicking the "Save Settings button".

• Fixed the client-side errors related to users not being on a high enough game build to support the new blackout natives.

v1.3.5

02/05/2022

Files Changed:

• All files

• Specific Files

fxmanifest.lua
server/server.lua

Changelog:

Fix

• Minor typo fix - geeknessfr

v1.3.6

13/06/2022

Files Changed:

• All files

• Specific Files

fxmanifest.lua
server/server.lua
client/client.lua

Changelog:

Add

• Added server and client exports to get the weather data. See docs.

1.3.7

15/02/2023

Files Changed:

• All files

• Specific Files

Changelog:

Fix

• Fixed esx depreciated event warnings.

• Fix the issue with dynamic weather not loading correctly if false. Credits - JanBlk.

• Re-enable driveby after menu access and set clock speed for time sync. Credits - elenawinters.

2.0.0

22/10/2024

Files Changed:

• All files

• Specific Files

Changelog:

Add

• Added Real Time and Real Weather. The can be used together or independently, such as game time but real life weather.

• Added auto detect for framework and notification resources.

• Added discord roles as a permission method.

• Added QBox compatibiliy.

Edit

• Time changes (minute to minute) are much smother now.

Fix

• fix