Troubleshooting

/substances 명령어 입력 시 권한이 없다고 나오는 경우

에디터는 ACE 권한으로 보호되어 있습니다. 다음 중 하나를 설정해 주세요:

add_ace group.admin bupa.substances allow

또는 Config.Creator.Developers에 본인의 라이센스 식별자를 추가하세요. Config.Creator.UseAce = false로 설정하면 ACE 체크는 제거되지만 개발자 목록은 계속 유지됩니다.

아이템을 사용해도 아무 일도 일어나지 않는 경우

리소스가 인식하기 전에 해당 아이템이 사용 가능한 아이템(usable)으로 등록되어 있어야 합니다.

• ox_inventory의 경우, 항목에 server = { export = 'bupa-addictioncreator.useSubstance' }가 포함되어야 합니다. 이 설정이 없으면 인벤토리가 리소스에 아이템 사용 사실을 전달하지 않습니다.
• QBox, QB-Core 및 ESX에서는 리소스가 코어를 통해 직접 핸들러를 등록하므로, 아이템에 useable = true만 설정해주면 됩니다.
• 에디터의 아이템 이름이 인벤토리의 아이템 이름과 대소문자까지 정확히 일치하는지 확인하세요.

아이템은 사라지는데 아무 일도 일어나지 않는 경우

사용 시 인벤토리에서 아이템이 소모되는 정상적인 현상입니다. ox_inventory 항목에 consume = 0을 추가해 주세요. 리소스가 허용된 투여량임을 확인한 후에 직접 아이템을 제거합니다.

저장 후 에디터에 아무것도 나타나지 않는 경우

물질은 저장되었으나 클라이언트에 게시되지 않은 상태입니다. 서버 시작 시 콘솔을 확인해 보세요. 로드된 물질의 수가 출력됩니다. 0이 출력된다면 SQL이 임포트되지 않았거나 Config.Tables.Substances가 존재하지 않는 테이블을 가리키고 있는 것입니다.

효과가 너무 강력한 경우

Effects 탭의 모든 값은 곡선(curve)이 곱해진 **최고점(peak)**입니다. 대부분의 구간에서 최고점에 머무는 곡선과 1.0의 블러(blur) 값은 정상적으로 작동하는 것이지만 플레이하기에 너무 버겁습니다. 값을 낮추거나 최고점에 머무는 시간을 줄이도록 곡선을 다시 조정하세요. 플레이어들이 겪기 전에 Apply to me를 사용하여 직접 테스트해 보세요.

플레이어들이 계속 과다복용(overdose)하는 경우

부하 임계값(load threshold)은 저녁 시간 동안 많은 양을 복용해서가 아니라, 짧은 시간 안에 빠르게 복용할 때 초과됩니다. 너무 자주 발생한다면 에디터에서 물질별 **cost(비용)**를 낮추거나 Config.Overdose.Threshold를 높이세요. cost가 20인 물질은 부하가 전혀 감소하지 않은 상태에서 5번의 투여를 허용하므로, 딜러들이 판매하는 속도에 맞춰 이 숫자를 확인해 보세요.

금단 현상을 겪는 플레이어가 전혀 없는 경우

금단 현상은 마지막 투여 시점을 기준으로 측정되므로, 꾸준히 공급받는 플레이어는 이를 겪지 않습니다. 아예 발동하지 않는다면 첫 번째 단계의 after 값을 확인해 보세요. 120분은 현실 시간으로 2시간이며, 세션이 짧은 서버에서는 이 시간에 도달하지 못할 수 있습니다. 첫 번째 단계의 시간을 앞당겨 보세요.

휴식 후 금단 현상이 바로 위기 상태로 건너뛰는 경우

Config.Withdrawal.RunsOffline이 켜져 있고 플레이어가 제한 시간(cap)보다 오래 접속하지 않은 경우입니다. Config.Withdrawal.OfflineCap을 낮추거나, RunsOffline = false로 설정하여 로그아웃 시 타이머를 완전히 정지시키세요.

의사가 플레이어를 진찰할 수 없는 경우

직업 이름이 Config.Medical.Jobs와 정확히 일치하고 등급이 MinGrade 이상인지 확인한 다음 거리를 확인하세요. 진찰과 치료 모두 서버에서 검증되며 Config.Medical.Distance에 약간의 여유분을 더한 거리 이상에서는 거부됩니다.

차트가 거의 비어 있는 경우

Medical 탭이 정상적으로 작동하고 있는 상태입니다. 각 물질은 의사에게 무엇을 보여줄지 결정하며, 모든 기능이 꺼진 물질은 의사에게 카테고리 외에는 아무것도 보여주지 않습니다. 볼 수 있게 만들고 싶은 물질의 토글을 다시 켜세요.

인터페이스에서 아이템 이미지가 빈 화면으로 나오는 경우

인벤토리의 이미지 폴더에서 자동으로 감지되어 불러와집니다. 이름을 변경한 포크(fork) 버전의 경우, 리소스에 경로를 직접 지정해 주세요:

Config.UI.ImagePath = 'nui://my-inventory/web/images/'

버전 체크에서 에러가 출력되는 경우

리소스가 시작될 때 GitHub에 현재 버전을 요청합니다. 여기서 HTTP 에러가 발생한다는 것은 서버가 raw.githubusercontent.com에 도달할 수 없음을 의미하며, 방화벽 문제이거나 일시적인 서버 장애일 수 있습니다. 리소스의 기능에는 전혀 영향을 주지 않으며, 체크 후 단순히 메시지를 출력하고 넘어갑니다.