JoyPro2 Discord GitHub
Pelit

G-Rebels

Näytä:

G-Rebels on Unreal Engine 5:llä tehty kyberpunk-lentotaistelupeli: lennät VTOL-koneella megakaupunkien yllä. Peli asettaa jokaisen päälle kytkemäsi joystickin kanavalle (0–5) ja säilyttää jokaisen akselin roolin (pitch, roll, yaw, thrust, strafe, up / down) ja painikemääritykset kanavittain kahdessa tallennustiedostossa. JoyPro lukee nämä roolit ja näppäinmääritykset profiiliisi ja kirjoittaa ne takaisin; näppäimistö, peliohjain ja hiiri pysyvät sellaisina kuin peli ne on asettanut.

G-Rebels natiivi (omat näppäinmääritystiedostot)
Tuki
natiivi (omat näppäinmääritystiedostot)
Moottorin komento
engine grebels
Näppäinmääritystiedosto
%LOCALAPPDATA%\G_Rebels\Saved\SaveGames\SaveOptions.sav (GVAS, akselien roolit muutetaan paikallaan) + EnhancedInputUserSettings.sav (painikkeet)
Pelin lukemat tulot
lukee 96 painiketta, 24 akselia, ei Hateja joystickia kohden (dokumentoitu)
Komentoluettelon lähde
JoyPron oma taulukko (akselien roolit, painikkeet)
Pelinsisäinen testi
18/18 vaihetta läpäisty (2026-10-11)
  • ✓ Tuo
  • ✓ Vie
  • ✗ Näppäimistön näppäinmääritykset
  • ✗ Muuntimet
  • ✓ Komentoluettelo rakennetaan PC:lläsi
  • ✓ Pelien seuranta
  • ✗ Akselikäyrät ja kuolleet alueetG-Rebels: vain kääntö.
  • ✗ Pelin ohjainasetukset
  • ✗ Pelin voimapalauteasetukset
  • ✗ Voimapalaute telemetriasta
  • ✗ Telemetrian tallennus
  • ✓ Virtuaalinen joystick (vJoy)
  • ◐ Virtuaalinen Xbox-ohjain
  • ✓ Virtuaaliset toiminnot
  • ◐ Ohjattu määritys / Automaattinen määritys
  • ✗ Ohjaamot
  • ✓ Pikaohjeet
  • ✓ Pelinsisäinen testi

Tukimatriisista, joka on luotu moottorin koodista: kaikki pelit.

Aloittelijoille

#Käyttöön 3 vaiheessa

  1. Tee kaikki puolestani
    Alku-sivulla
  2. Käytä näitä painikkeita
    katso ensin luettelo
  3. Kirjoita peliini
    pidä G-Rebels suljettuna

Ennen, kerran laitetta kohden pelissä: anna sille kanava kohdassa OPTIONS > INPUT > DEVICES. Muuta yhtä akselin roolia sen JST-välilehdellä. Määritä yksi painike. (Lisätietoja alla.)

Sitten: näppäinmäärityksesi näkyvät laitteen JST-välilehdellä.

Määrititkö painikkeita G-Rebelsissä aiemmin? Silloin Alku-sivu tarjoaa vaihtoehdon Tuo ja täytä sitten aukot. Näppäinmäärityksesi säilyvät, ja vain vapaat painikkeet saavat uusia tehtäviä. Katso Pika-aloitus: saa ohjainsauvani toimimaan.

#Mitä JoyPro tekee G-Rebelsille

  • Tuo: jokaisen kanavan akselien roolit (mikä ohjainsauvan akseli on pitch, roll, yaw, thrust, side strafe, up / down) käänteisyyksineen sekä JoyPron tuntemat painikemääritykset tulevat profiiliisi oikeille laitteillesi.
  • Suhteet: ”Pitch” G-Rebelsissä voi olla sama suhde kuin pitch muissa peleissäsi.
  • Vie: JoyPro asettaa akselien roolit ja painikemääritykset laitteidesi kanaville. Se ei koskaan lisää kanavaa tai laitetta: sen osan teet kerran pelissä.

#Tuo G-Rebelsin näppäinmäärityksesi

  1. Avaa Alku-sivu. Jos G-Rebels-kortti pyytää komentoluetteloa, paina Luo luettelo: JoyPro kirjoittaa oman taulukkonsa pelin akselirooleista ja painikkeista.
  2. Paina G-Rebels-kortin Tuo, pidä Lisää profiiliini (suositeltu) valittuna ja paina Tuo nyt.
  3. Näytä suhteeni avaa sen, mitä tuli.
Alku-sivu ja pelisiAlku-sivu ja pelisi
Alku-sivu ja pelisi (Kuvat näyttävät sovelluksen englanniksi.)

#Rakenna ja tarkista suhteet

Määritä suhteesi G-Rebelsin toimintoihin Suhteet-sivulla (katso suhteiden työnkulku) ja suorita sitten Vie-sivulla Tarkista. G-Rebels sallii yhden roolin akselia kohden ja yhden painikkeen toimintoa ja kanavaa kohden; Tarkistus näyttää, missä kaksi suhdetta haluaa saman tulon.

#Vie G-Rebelsiin

  1. Sulje G-Rebels. JoyPro kieltäytyy kirjoittamasta pelin ollessa käynnissä.
  2. Avaa Vie-sivu ja valitse G-Rebels-kortti.
  3. Pidä Korvaa laitteillani ja Tyhjennä myös muut laitteeni valittuina, jos määrität ohjainsauvasi JoyProssa. Paina kortin Vie nyt.
Vie-sivuVie-sivu
Vie-sivu
Pelissä: Mitä näet G-Rebelsissä

Avaa OPTIONS > INPUT > CONTROLS ja laitteesi välilehti JST<channel> (JST0 kanavalle 0). Kohdassa AXIS jokainen joystickin akseli (X, Y, Z, RX, RY, RZ, Slider, Dial) näyttää JoyPron asettaman roolin (YAW, THRUST, ROLL, PITCH, SIDE STRAFE, UP / DOWN tai NONE). Kohdassa BUTTONS määritetty toiminto näyttää painikkeesi, esimerkiksi ”Enhanced Raw Input Controller 0 Button 5”.

#Mitä teet itse G-Rebelsissä

Tee tämä kerran laitetta kohden ennen ensimmäistä vientiä:

  1. Kytke laite päälle: OPTIONS > INPUT > DEVICES luettelee jokaisen joystickin tilassa DEACTIVATED. Anna jokaiselle haluamallesi laitteelle kanava (0 - CHANNEL ... 5 - CHANNEL). Vienti ohittaa laitteen, jolla ei ole kanavaa, ilmoituksella ”kytke se päälle kohdassa OPTIONS > INPUT > DEVICES”.
  2. Muuta yhtä akselin roolia laitteen JST-välilehdellä. Vasta silloin peli tallentaa kanavan akselirivit; JoyPro muuttaa niitä paikallaan eikä koskaan lisää niitä. Pelkkä välilehden avaaminen ei tallenna mitään.
  3. Määritä yksi painike pelissä kerran. Painiketiedosto ilmestyy ensimmäisen näppäinmäärityksen myötä.

#Yleiset sudenkuopat

  • Akselin roolia ei kirjoiteta: kanavalla ei ole vielä tallennettuja akselirivejä. Muuta yhtä akselin roolia sen JST-välilehdellä pelissä, sulje peli ja vie uudelleen.
  • Painikemääritys puuttuu: pelin painikkeista vain Primary Fire on toistaiseksi vahvistettu; muut toiminnot seuraavat, kun niiden nimet tiedetään.
  • Useat raw input -laitteet käyttävät samoja tunnisteita: siirrä koko HOTAS yhdelle laitteelle Virtuaalisella joystickilla; se tarvitsee silloin vain yhden kanavan.
Lisäasetukset

#Tiedostot, joita JoyPro lukee ja kirjoittaa

Tiedosto Mikä se on
%LOCALAPPDATA%\G_Rebels\Saved\SaveGames\SaveOptions.sav laitteet kanavineen (HID-polun mukaan) ja yksi akselirivi kunkin kanavan jokaista akselia kohden: rooli, kääntö, kuollut alue, kerroin
%LOCALAPPDATA%\G_Rebels\Saved\SaveGames\EnhancedInputUserSettings.sav painikkeiden näppäinmääritykset, yksi kartoitus toimintoa ja kanavaa kohden
...\SaveOptions.sav.joypro-meta.json JoyPron tiedot viedyistä näppäinmäärityksistä (nimet, ryhmät), jotka seuraava tuonti lukee takaisin

Molemmista tallennustiedostoista otetaan varmuuskopio ennen ensimmäistä kirjoitusta (.jpbak niiden vieressä ja JoyPron varmuuskopiovarasto).

#Vientitilat G-Rebelsissä

Yksi rooli akselia kohden ja yksi näppäin toimintoa ja kanavaa kohden. Samat säännöt pätevät akselirooleihin ja painikkeisiin.

Tila Mitä tapahtuu
Vain lisää Rooli menee vain akselille, jolla ei ole roolia; akseli, jolla on toinen rooli, ohitetaan ja merkitään ”Ei kirjoitettu peliin”.
Päivitä, säilytä pelin määritykset Profiilin rooli menee akselilleen (siellä ollut rooli poistuu); rooli säilyy muilla akseleillaan. Painike: toisen toiminnon kartoitus näppäimessä poistuu.
Päivitä, profiilini voittaa Kuten yllä, ja roolin muut akselit liitetyillä kanavilla saavat arvon NONE.
Korvaa laitteillani Kirjoitetun kanavan jokaisesta muusta roolista tulee NONE.
+ Tyhjennä myös muut laitteeni Sama käytössä olevilla, liitetyillä kanavilla, joihin JoyPro ei kirjoita.

#Mihin ei koskaan kosketa

  • Näppäimistö, peliohjain, hiiri ja pelin muut valinnat.
  • Kanava, jonka laitetta ei ole liitetty, säilyttää roolinsa.
  • Tuonnissa ohitetut laitteet ja vJoy-laite, johon JoyPro tunneloi.
  • Pelin laiteluettelo: JoyPro ei koskaan kytke laitetta päälle tai pois eikä koskaan lisää kanavaa.

#Akselit ja muut asetukset

  • Yleinen: yksi näppäinmäärityssarja kanavaa kohden, ei ilma-alusprofiileja.
  • Käännä kirjoitetaan roolin kanssa. Hatteja (POV-rivit), kuollutta aluetta ja herkkyyttä ei vielä kirjoiteta.
  • Ei koko peliä koskevia asetuksia, ei voimapalautetta.
  • Seuranta: pelissä muuttamasi rooli tai näppäinmääritys huomataan pelin sulkeuduttua (seuranta).
  • HUD: G-Rebelsin ollessa käynnissä HUD näyttää kunkin painetun painikkeen toiminnon.
  • Peli lukee laitetta kohden enintään 96 painiketta ja 24 akselia, ei Hatteja.
Tekninen

#G-Rebels-integraation sisältä

flowchart LR
  D["G-Rebels: DEVICES<br/>laite kanavalla 0-5"] --> S
  P["Profiilisi<br/>(suhteet + näppäinmääritykset)"] --> E["engine grebels export"]
  E --> S["SaveOptions.sav<br/>akseliroolit + kääntö<br/>kanavaa kohden"]
  E --> B["EnhancedInputUserSettings.sav<br/>painikkeiden näppäinmääritykset kanavaa kohden"]
  S --> G["G-Rebels: CONTROLS ><br/>kanavan JST-välilehti"]
  B --> G
Annat pelissä kerran jokaiselle laitteelle kanavan. JoyPro kirjoittaa kyseisen kanavan akseliroolit ja painikkeet.

Koodi: engine\Games\GRebelsIntegration.cs, engine\Games\GRebelsSaveOptions.cs, engine\Games\GvasKeyMappings.cs.

  • SaveOptions.sav: Unreal GVAS (UE 5.8, ominaisuustunnisteet tyyppipuineen). Joysticks sisältää S_Controller_Save { DeviceID (HID path), Enabled, MultiID (channel) }; AxisOptions sisältää S_Input_Axis_Save { Key, Offset, Multiplier, Role, Inverted, DeadZone }, jossa on avaimia kuten RawInput_Controller0_AxisY ja rooli enum-arvona (0 Yaw, 1 Thrust, 2 Roll, 3 Pitch, 4 Side strafe, 5 Up/down, 6 None). Ei tarkistussummaa: JoyPro muokkaa kiinteäkokoisia arvoja paikallaan.
  • EnhancedInputUserSettings.sav: Unreal Enhanced Inputin pelaajan määrittämät näppäimet. Kartoitusten nimet ovat muotoa <ACTION>JST<channel> (PRIMARYFIREJST0), näppäimet RawInput_Controller<channel>_Button<n>, jossa n on DirectInputin painikenumero. Kartoitusluettelo kirjoitetaan uudelleen; jokainen muu tavu säilyy.
  • Laitteet: tunnistetaan HID-polun mukaan siihen kanavaan, jonka peli niille antoi.
  • Komentoluettelo: JoyPron oma taulukko (DB\GRebels\actions.tsv, akseliroolit ja painikkeet; pelin tiedostoja ei lueta). engine grebels refresh-db kirjoittaa sen pelitietokansioon; jo olemassa olevat rivit säilyttävät merkintänsä.
  • Komennot: engine grebels paths, engine grebels catalog, engine grebels scan, engine grebels import, engine grebels export --mode clean|add|merge|merge-overwrite --nuke-untouched-devices --dry-run.

#Tunnetut rajoitukset

  • Hatteja, kuollutta aluetta ja herkkyyttä ei kirjoiteta.
  • Painikkeista vain Primary Fire on vahvistettu pelissä.
  • Merkintöjä ei koskaan lisätä: kanavien, akselirivien ja painiketiedoston on oltava pelin luomia.
  • Testit: engine\tests\smoke\grebels.ps1; pelissä tools\e2e\games\GRebelsSettings.ps1 (kaksi käynnistystä: ensimmäinen antaa vJoylle kanavan ja tallentaa akselirivit, toinen tarkistaa satunnaiset roolit ja Primary Fire -toiminnon kanavalla JST0; tallennuskansio palautetaan jälkeenpäin).

Kaikki tämän pelin tekniset huomiot (luotu repositoriosta): g-rebels.md.