Felsökning av vanliga problem

Trots att EarnFX är utformat för att fungera smidigt kan tekniska problem ibland uppstå. Här är en guide för att identifiera och lösa vanliga problem som kan påverka både resursen och dess funktionalitet på din FiveM-server.

1. Resursen startar inte

Symptom: Resursen syns inte i serverkonsolen vid uppstart.
Möjliga orsaker och lösningar:

Fel placering av resursen

Se till att mappen EarnFX_Master ligger i serverns resources-mapp.

Resursen är inte aktiverad i server.cfg
Kontrollera att följande rad finns i din server.cfg:

ensure EarnFX_Master

Fel i filerna

Om inställningsfiler som settings.json är skadade eller felaktigt formaterade kan resursen misslyckas med att starta. Kontrollera filens syntax, t.ex. med en JSON-validator.

FiveM-versionen är för gammal

Se till att du använder den senaste versionen av FiveM-servern.

2. Användarmenyn öppnas inte

Symptom: Spelare kan inte öppna användarmenyn trots att resursen verkar startad.

Möjliga orsaker och lösningar:

Felaktig keybind

Kontrollera i settings.json under "Actions" att rätt knapp har valts:

{
    "type": "in-game-button",
    "keybind": "F9"
}

Testa att byta till en annan knapp, t.ex. F10, om F9 redan används av en annan resurs.

Konflikter med andra resurser

Temporärt inaktivera andra resurser som kan använda samma knapp eller händelser för att säkerställa att det inte finns några konflikter.

Händelsebaserad öppning fungerar inte

Om du använder on-client-event eller on-server-event, kontrollera att händelsen faktiskt triggas i skripten och att den matchar eventname i settings.json.

3. Betalningar registreras inte

Symptom: Donationer genomförs av spelare men syns inte i EarnFX eller Stripe.
Möjliga orsaker och lösningar:

Felaktig Stripe-konfiguration

Kontrollera att Stripe är korrekt konfigurerat och länkat till din server genom att följa installationsguiden för betalningar.

Logga in på ditt Stripe-konto och kontrollera om betalningarna har registrerats där.

Fel e-postadress i settings.json

Kontrollera att fältet "EmailAdress" i settings.json matchar den e-postadress du registrerat på EarnFX.

Serverproblem med Stripe

Om Stripe inte svarar korrekt kan det bero på tillfälliga serverproblem. Vänta och försök igen.

4. Webhook-funktionalitet fungerar inte

Symptom: Användarspecifika belöningar via webhook skickas inte eller fungerar inte som förväntat.
Möjliga orsaker och lösningar:

Felaktig URL

Kontrollera att URL:en för webhook är korrekt och att den tjänst du försöker nå är aktiv.

Fel metod eller headers

Kontrollera inställningarna för webhookmethod och webhookheaders i din settings.json och säkerställ att de matchar tjänstens krav.

Fel i datan

Använd en testtjänst som Webhook.site för att se vilken data som skickas och åtgärda eventuella fel.

5. Spelaren får inga belöningar

Symptom: Spelare som donerar får inte utlovade belöningar som Discord-roller eller fordon.
Möjliga orsaker och lösningar:

Felaktig konfiguration av planer

Kontrollera att alla planer och belöningar är korrekt konfigurerade i "Plans"-sektionen i settings.json.

Exempel:

{
    "amount": 250,
    "name": "Member",
    "description": "Exklusiv discordroll",
    "perks": [
        {
            "type": "trigger-webhook",
            "webhookadress": "https://example.com/webhook"
        }
    ]
}

Skript för belöningar saknas eller fungerar inte

Om belöningar kräver ett separat skript, kontrollera att detta är aktivt och att det inte finns några fel i serverkonsolen.

6. Kontrollpanelen laddar inte

Symptom: Kontrollpanelen går inte att öppna eller ger felmeddelanden.
Möjliga orsaker och lösningar:

Fel URL

Kontrollera att du använder rätt URL, som visas i serverkonsolen vid uppstart.

Servern är offline

Kontrollera att din server körs och att resursen EarnFX är startad.

Felaktig inloggning

Kontrollera att du använder rätt e-postadress och lösenord. Om du glömt lösenordet, återställ det via kontrollpanelen.

7. Allmän felsökning

Om du inte hittar en lösning på problemet:

Kontrollera serverkonsolen

Leta efter felmeddelanden som hänvisar till EarnFX och åtgärda dem.

Testa med en ren installation

Ta bort EarnFX_Master från resources, ladda ner och installera resursen på nytt.

Sök hjälp

Kontakta EarnFX support via support@ilution.se och bifoga följande:

• Serverloggar med eventuella felmeddelanden.
• En kopia av din settings.json.