HomeStoreResourcesFreeDiscord

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

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.Permissions.

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

Step 5 - Real Time & Weather

Easytime does not require a paid plan on Open Weather Map!

It is designed with the free plan in mind.

  1. Go to https://openweathermap.org and create an account.

  2. The API key should be automatically generated after account creation. To access it click on your profile name > My API Keys Double click the key and copy it.

  3. Paste this API key into Config.APIKey.

  4. Set Config.Time.METHOD and/or Config.Weather.METHOD to "game" and configure to suit your servers needs.

The free limit on OpenWeatherMap is

  • 60 requests per second

  • 1 million requests per month

Easytime should never exceed these limits, since by default it only makes 1 request every 30 minutes.

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.

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.

20/03/2021 - 22/03/2021

v1.1.4 - v1.1.7

Files Changed:

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.

Last updated

Was this helpful?