← 목록

mLua · Nemotron SDG 질문-응답 (SFT)

총 21,567개 · 페이지 672/719
🔀 랜덤
불러오는 중…

[task] | single_turn [pass] | ⏳ 미판정 [title] | 비정상 거래 대응 가이드 [question] | 거래 후 판매 대금 획득 시 대기 시간을 추가하면, 그 대기 시간 동안 플레이어가 다른 거래를 진행할 수 있나요? [answer] | 제공된 문서에는 거래 후 판매 대금 획득 시 대기 시간을 추가하는 것의 목적(비정상 거래 확인 및 선제적 대응 시간 확보)과 함께 거래 제한 기간을 재화 설명에 명시해야 한다는 안내만 포함되어 있습니다. 그러나 **대기 시간 동안 플레이어가 다른 거래를 진행할 수 있는지 여부에 대한 구체적인 기술적 제약 사항이나 정책적 내용은 문서에 명시되어 있지 않습니다.** 따라서 이 부분에 대해서는 문서의 내용만으로는 판단할 수 없으며, 월드를 제작할 때 크리에이터님께서 원하는 대로 거래 시스템의 로직을 설계하셔야 합니다. 만약 대기 중 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 월드가 성장하고 다수의 유료 상품이 추가되면 더욱 다양한 형태의 거래 및 결제 행위가 발생할 수 있으며 이러한 거래 행위가 올바르게 관리될 수 있도록 본 가이드를 마련하였습니다. 비정상 거래로 인한 피해로부터 크리에이터님의 콘텐츠를 보호할 수 있도록 안내드리는 가이드에 맞춰 사전 예방하시는 것을 권장해 드립니다. # 비정상 거래 대응의 필요성 크리에이터는 크리에이터가 제작한 월드에서 운영정책 위반 행위가 발생하지 않도록 플레이어 간의 거래 방식과 거래 시스템에 대해 긴밀한 관리가 필요합니다. * 플랫폼에서 금지하고 있는 비정상

[task] | code [pass] | ⏳ 미판정 [title] | mLua [question] | `@Event` 어노테이션을 적용하여 `EventType`을 상속받는 스크립트를 작성하고, `---@type string` 타입 어노테이션을 사용하여 로컬 변수를 선언해 주십시오. [answer] | `@Event` 어노테이션을 사용하여 `EventType`을 상속받는 스크립트를 작성하고, `---@type string` 타입 어노테이션을 적용한 로컬 변수 선언 예시는 다음과 같습니다. ```lua @Event script NewEvent extends EventType { function NewEvent:OnBeginPlay() ---@type string local testValue = "test" end } ``` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | #### MaxLength Attribute MSW 메이커의 프로퍼티 에디터에 최대 길이를 지정합니다. 적용 대상은 **string 타입의 프로퍼티**입니다. * 매개 변수: **integer** ```lua @MaxLength(5) property string NewVlaue = "test" ``` #### Component Attribute 스크립트를 Component로 지정합니다. 적용 대상은 **스크립트**입니다. * 매개 변수: **없음** ```lua @Component script NewComponent e

[task] | two_turn [pass] | ⏳ 미판정 [title] | mLua [question] | mLua 스크립트 정의문에서 다른 타입으로부터 상속받을 때 `extends` 구문을 어떻게 사용해야 하며, 프로퍼티 정의 시 우측 식 작성이 생략되는 예외 타입은 무엇인가요? [answer] | mLua 스크립트에서 다른 타입으로부터 상속을 받기 위해서는 스크립트 정의문에 `extends` 키워드를 사용하여 상속받는 원본 타입명을 명시해야 합니다. 기본 스크립트 정의문은 `script 타입이름`으로 시작하지만, 상속 관계가 있는 경우 `script 타입명 extends 타입명` 형식을 사용합니다. 프로퍼티를 정의할 때는 일반적으로 `property 타입명 이름 = 식` 형태로 우측 식(초기값)을 반드시 작성해야 합니다. 하지만 **SyncTable** 타입은 할당이 불가능한 타입이므로 예외적으로 우측 식 작성을 생략할 수 [followup] | `SyncTable` 타입 프로퍼티를 정의하는 코드 예시와, 상속 관계가 있는 스크립트 정의문의 전체 문법을 함께 설명해주세요. [followup_answer] | `SyncTable` 타입의 프로퍼티는 할당이 불가능하기 때문에 정의 시 우측 식(초기값)을 생략합니다. 상속 관계가 있는 스크립트 정의문은 `script` 키워드 뒤에 현재 스크립트 타입명, `extends` 키워드, 그리고 상속받는 원본 타입명을 순서대로 적고 `end`로 마무리합니다. 두 요소를 함께 적용한 전체 코드 예시는 다음과 같습니다. ```lua script MyDerivedScript extends MyBaseScript property SyncTable MySyncTable end ``` 여기서 `My [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 메이플스토리 월드 메이커를 벗어나 외부 편집기에서 스크립트를 작성하기 위해서는 mLua 문법에 맞게 작성해야 합니다. mLua의 문법에 대해 알아봅시다. ##### 참고 가이드 [LocalWorkspace](/docs/?postId=1165) [ExtendedScriptFormat](/docs/?postId=1166) [mLua Extension](/docs?postId=1209) [공동 제작](/docs/?postId=670) # mLua MSW 메이커의 스크립트 엔트리를 표현하기 위한 프로그래밍 언어입니

[task] | code [pass] | ⏳ 미판정 [title] | mLua [question] | `@Item` 어노테이션을 적용하여 `Item`을 상속받는 스크립트를 작성하고, `---@param param Entity` 파라미터 어노테이션을 가진 함수를 정의해 주십시오. [answer] | `@Item` 어노테이션을 적용하여 `Item`을 상속받는 스크립트와, `---@param param Entity` 파라미터 어노테이션을 가진 함수를 정의한 코드는 다음과 같습니다. ```lua @Item script NewItem extends Item end ---@param param Entity local function TestFunction(param) end ``` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | #### MaxLength Attribute MSW 메이커의 프로퍼티 에디터에 최대 길이를 지정합니다. 적용 대상은 **string 타입의 프로퍼티**입니다. * 매개 변수: **integer** ```lua @MaxLength(5) property string NewVlaue = "test" ``` #### Component Attribute 스크립트를 Component로 지정합니다. 적용 대상은 **스크립트**입니다. * 매개 변수: **없음** ```lua @Component script NewComponent e

[task] | code [pass] | ⏳ 미판정 [title] | mLua [question] | `@State` 어노테이션을 적용하여 `StateType`을 상속받는 스크립트를 작성하고, `---@type integer` 타입 어노테이션을 사용하여 할당문에서 값을 지정해 주십시오. [answer] | `@State` 어노테이션을 적용하여 `StateType`을 상속받는 스크립트와 `---@type integer` 타입 어노테이션을 사용한 할당문은 다음과 같습니다. ```lua @State script NewState extends StateType ---@type integer local testValue = 10 end ``` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | #### MaxLength Attribute MSW 메이커의 프로퍼티 에디터에 최대 길이를 지정합니다. 적용 대상은 **string 타입의 프로퍼티**입니다. * 매개 변수: **integer** ```lua @MaxLength(5) property string NewVlaue = "test" ``` #### Component Attribute 스크립트를 Component로 지정합니다. 적용 대상은 **스크립트**입니다. * 매개 변수: **없음** ```lua @Component script NewComponent e

[task] | single_turn [pass] | ⏳ 미판정 [title] | mLua [question] | `---@deprecated`와 `---@sealed` 어노테이션은 각각 어떤 정의문에 사용할 수 있으며, 그 차이점은 무엇인가요? [answer] | `---@deprecated`와 `---@sealed` 어노테이션은 사용 가능한 대상과 목적에서 명확한 차이가 있습니다. **1. 사용 가능한 정의문** * **`---@deprecated`**: 스크립트 정의문, 프로퍼티 정의문, 메소드 정의문, 이벤트 핸들러 정의문에 사용할 수 있습니다. * **`---@sealed`**: 프로퍼티 정의문, 메소드 정의문, 이벤트 핸들러 정의문에 사용할 수 있습니다. (스크립트 정의문에는 사용할 수 없습니다.) **2. 차이점 (목적)** * **`---@deprecated`* [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | Return Annotation은 대상 함수의 반환 타입을 지정할 수 있습니다. 함수 정의문, 메소드 정의문에 사용할 수 있습니다. Return Annotation은 대상 함수의 반환 타입을 지정하여 스크립트 어시스트의 도움을 받을 수 있습니다. ```lua ---@return TYPE ``` **사용 예시** ```lua ---@return Entity local function TestFunction(testParamA, testParamB) return self.Entity end ``` ```lua ---@retu

[task] | instruction_following [pass] | ⏳ 미판정 [title] | FastVector3을 활용한 월드 최적화 [question] | Position 값을 변경할 때 참조 객체 생성을 피하기 위해 FastVector3을 올바르게 사용하는 mLua 코드만 출력하고 설명은 주석으로 작성해 주세요. [answer] | ```lua Property: [None] any tempPosition = nil Method: [server only] void OnUpdate(number delta) { local transform = self.Entity.TransformComponent -- PositionAsFastVector3() 함수를 사용하여 참조 객체 생성 없이 현재 위치를 FastVector3으로 가져옴 local positionFast = transform:PositionAsFastVector3() [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 최적화를 위해 `Vector3` 대신 `FastVector3`을 사용하는 이유는 값을 생성하거나, 읽어올 때 **참조 객체를 생성하지 않기 때문**입니다. `Vector3`의 경우 Lua 스크립트에서 사용하기 위해 참조 객체가 필요합니다. 메이플스토리 월드의 `Vector3` 객체를 사용하면 참조 객체가 자동으로 생성, 파괴됩니다. 그러나 이 과정에서 처리 시간이 길어지고 메모리 사용량이 증가해 최적화가 필요하게 됩니다. ```lua -- Position 값을 읽어올 때 참조 객체가 생성됨 local position = self

[task] | two_turn [pass] | ⏳ 미판정 [title] | mLua [question] | mLua에서 스크립트 멤버에 동기화 기능을 적용하기 위해 사용할 수 있는 Attribute의 종류와 기본 문법은 무엇인가요? [answer] | mLua에서 스크립트 멤버에 동기화 기능을 적용하기 위해 사용할 수 있는 Attribute는 **Sync**와 **TargetUserSync** 두 가지입니다. ### 1. Sync Attribute 프로퍼티의 동기화 여부를 지정하는 Attribute입니다. * **적용 대상**: 동기화 가능한 Property 타입의 프로퍼티 * **매개 변수**: 없음 * **기본 문법**: ```lua @Sync property string NewValue = nil ``` ### 2. TargetUs [followup] | @Sync와 @TargetUserSync Attribute의 적용 대상(프로퍼티/컴포넌트)과 매개 변수 유무에 따른 구체적인 코드 예시를 보여주세요. [followup_answer] | 참고 문서에 명시된 정보에 따르면, `@Sync`와 `@TargetUserSync` Attribute의 적용 대상과 매개 변수, 그리고 문서에 포함된 코드 예시는 다음과 같습니다. ### 1. @Sync Attribute * **적용 대상**: 동기화 가능한 Property 타입의 프로퍼티 (적용 가능 타입: Component, Logic, BTNode) * **매개 변수**: 없음 * **코드 예시**: ```lua @Sync Property string NewValue = nil ``` [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 메이플스토리 월드 메이커를 벗어나 외부 편집기에서 스크립트를 작성하기 위해서는 mLua 문법에 맞게 작성해야 합니다. mLua의 문법에 대해 알아봅시다. ##### 참고 가이드 [LocalWorkspace](/docs/?postId=1165) [ExtendedScriptFormat](/docs/?postId=1166) [mLua Extension](/docs?postId=1209) [공동 제작](/docs/?postId=670) # mLua MSW 메이커의 스크립트 엔트리를 표현하기 위한 프로그래밍 언어입니

[task] | single_turn [pass] | ⏳ 미판정 [title] | FastVector3을 활용한 월드 최적화 [question] | FastVector3의 메타테이블을 통해 새로운 함수를 추가할 때 어떤 코드를 작성해야 하나요? [answer] | `FastVector3`의 메타테이블을 통해 새로운 함수를 추가하려면 `getmetatable(FastVector3.zero)`를 호출하여 메타테이블을 가져온 후, 해당 메타테이블에 함수를 할당해야 합니다. 다음과 같은 코드를 작성할 수 있습니다. ```lua local v3mt = getmetatable(FastVector3.zero) v3mt.NewFunction = function(self) -- ... end ``` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `FastVector3`은 **프로퍼티 타입, 함수의 매개변수**로 지정할 수 없습니다. 그러므로 `FastVector3`을 타입이나 매개 변수로 사용할 때는 **any, table** 타입을 사용해야 합니다. 특히 **mLua**를 사용할 때는 **any** 타입을 사용하고, 어노테이션(Annotation)을 함께 사용하기를 권장합니다. ```lua ---@type FastVector3 property any vt = FastVector3(0,0,0) ---@param vt FastVector3 method void NewM

[task] | instruction_following [pass] | ⏳ 미판정 [title] | FastVector3을 활용한 월드 최적화 [question] | FastVector3의 인덱스 접근이 키 접근보다 빠른 이유와 권장 사용 시나리오를 3문장 이내로 설명해 주세요. [answer] | FastVector3은 인덱스 접근이 키 접근보다 약간 더 빠르지만, 가독성이 낮아지므로 주의가 필요합니다. 따라서 인덱스 접근은 `Normalize()` 호출 빈도가 지나치게 높아 월드에 최대한의 최적화가 필요한 극소수의 상황에서만 권장됩니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `FastVector3`은 인덱스를 이용해 접근할 수도 있습니다. 아래 표를 보면 인덱스를 이용한 접근이 키를 이용한 접근보다 약간 더 빠른 것을 알 수 있습니다. ![[object Object]](https://mod-file.dn.nexoncdn.co.kr/bbs/17453667314987383595f55d84737a7cb12f62068050b.png{"width":"1080px"} "FastVector3Index") 인덱스를 이용해 `FastVector3`에 접근하는 예제는 아래와 같습니다. x는 1, y는 2, z는 3에

[task] | single_turn [pass] | ⏳ 미판정 [title] | FastVector3을 활용한 월드 최적화 [question] | 메이플스토리 월드에서 Native 타입 접근 시 참조 객체가 생성되는 과정과 메모리 정리 순서는 어떻게 되나요? [answer] | 메이플스토리 월드에서 Lua가 Native 타입에 접근하면 참조가 끊어지지 않도록 참조 객체가 생성됩니다. 이 객체는 사용이 종료된 후 두 단계의 가비지 컬렉션을 거쳐 메모리에서 완전히 제거됩니다. 메모리 정리 순서는 다음과 같습니다. 1. 먼저 Lua의 Garbage Collector가 메모리를 정리합니다. 2. 이후 Native의 Garbage Collector가 다시 한 번 정리 작업을 수행하여 메모리에서 완전히 제거됩니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `FastVector3`은 **프로퍼티 타입, 함수의 매개변수**로 지정할 수 없습니다. 그러므로 `FastVector3`을 타입이나 매개 변수로 사용할 때는 **any, table** 타입을 사용해야 합니다. 특히 **mLua**를 사용할 때는 **any** 타입을 사용하고, 어노테이션(Annotation)을 함께 사용하기를 권장합니다. ```lua ---@type FastVector3 property any vt = FastVector3(0,0,0) ---@param vt FastVector3 method void NewM

[task] | single_turn [pass] | ⏳ 미판정 [title] | mLua [question] | 이벤트 핸들러에 @EventSender를 적용할 때 첫 번째 인자로 "Entity"를 지정하면 두 번째 인자에 Entity Id를 입력해야 하는데, 이 Id 값을 어떻게 찾거나 얻어올 수 있나요? [answer] | 제공된 참고 문서에는 `@EventSender` Attribute의 첫 번째 인자로 `"Entity"`를 지정할 경우 두 번째 인자에 **Entity Id**를 입력해야 한다는 문법적 사항만 명시되어 있습니다. 그러나 해당 Entity Id 값을 **어떻게 찾거나 얻어올 수 있는지에 대한 구체적인 방법, API, 또는 절차는 제공된 문서에 포함되어 있지 않습니다.** 따라서 문서 근거만으로 이 값을 얻는 방법을 설명할 수 없습니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 메소드와 이벤트 핸들러의 실행제어 공간을 지정합니다. 파라미터는 string으로 지정된 문자열로만 사용이 가능합니다. 적용 대상은 **메소드, 이벤트 핸들러**입니다. 적용 가능 타입은 **Component, Logic**입니다. * 매개 변수: **string** ("Server", "Client", "ServerOnly", "ClientOnly", "Multicast") ```lua @ExecSpace("Client") @ExecSpace("Server") @ExecSpace("ServerOnly") @ExecSpace("C

[task] | single_turn [pass] | ⏳ 미판정 [title] | 비정상 거래 대응 가이드 [question] | 선제 조건으로 레벨 제한을 걸었는데, 여전히 비정상 플레이어가 퀘스트만 완료하고 바로 거래를 시도하는 경우가 많은데 추가로 걸 수 있는 조건이 있을까요? [answer] | 참고 문서에서 제시한 선제 조건 예시는 **레벨 제한**, **선행 퀘스트 완료**, **특정 업적 달성**입니다. 질문하신 상황(레벨 제한과 퀘스트 완료 조건이 있음에도 불구하고 비정상 플레이어가 거래를 시도하는 경우)에 대해, 문서에서 추가로 언급된 선제 조건 예시는 **특정 업적 달성**입니다. 따라서 레벨 제한과 퀘스트 완료 조건 외에 **특정 업적 달성** 조건을 추가로 설정하여 비정상 플레이어가 단기간에 거래를 진행하는 것을 지연시킬 수 있습니다. 또한, 선제 조건 외에도 문서에서는 비정상 거래를 사전 예방하기 위해 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 월드가 성장하고 다수의 유료 상품이 추가되면 더욱 다양한 형태의 거래 및 결제 행위가 발생할 수 있으며 이러한 거래 행위가 올바르게 관리될 수 있도록 본 가이드를 마련하였습니다. 비정상 거래로 인한 피해로부터 크리에이터님의 콘텐츠를 보호할 수 있도록 안내드리는 가이드에 맞춰 사전 예방하시는 것을 권장해 드립니다. # 비정상 거래 대응의 필요성 크리에이터는 크리에이터가 제작한 월드에서 운영정책 위반 행위가 발생하지 않도록 플레이어 간의 거래 방식과 거래 시스템에 대해 긴밀한 관리가 필요합니다. * 플랫폼에서 금지하고 있는 비정상

[task] | instruction_following [pass] | ⏳ 미판정 [title] | 로컬화된 Entity [question] | 로컬화된 엔티티에서 사용할 수 없는 컴포넌트와 서버 실행제어 함수 제한 사항을 2문장 이내로 설명하세요. [answer] | 로컬화된 엔티티에서는 PortalComponent를 사용할 수 없으며, 서버 기능을 사용하는 컴포넌트의 일부 기능이 정상적으로 동작하지 않을 수 있습니다. 또한 서버 실행제어 함수를 사용할 수 없습니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 클라이언트에서만 생성되는 로컬화된 엔티티에 대해 알아봅시다. ##### 참고 가이드 [서버와 클라이언트](/docs?postId=207) [예시로 알아보는 서버 검증](/docs?postId=1084) [패킷 변조 대비하기](/docs?postId=1102) [Effective MSW 2](/docs/?postId=560) # 로컬화된 엔티티 **로컬화된 엔티티(Localized Entity)**란 클라이언트에서만 생성되는 엔티티를 의미합니다. Hierarchy 창에서는 ![[object Object]]

[task] | single_turn [pass] | ⏳ 미판정 [title] | FastVector3을 활용한 월드 최적화 [question] | FastVector3과 Vector3의 실수형 비트 수 차이(8 Byte vs 4 Byte)로 인해 연산 결과가 달라질 수 있는 구체적인 사례나 주의점은 무엇인가요? [answer] | FastVector3과 Vector3은 각각 8 Byte(64-bit)와 4 Byte(32-bit) 실수형을 사용하므로, 두 타입 사이의 **유효 범위(정밀도)와 연산 결과가 달라질 수 있습니다.** 구체적인 주의점은 다음과 같습니다. 1. **정밀도 차이:** `Vector3`은 4 Byte 실수형을 사용해 상대적으로 정밀도가 낮고, `FastVector3`은 8 Byte 실수형을 사용해 더 높은 정밀도를 제공합니다. 2. **연산 결과 불일치:** 동일한 좌표나 벡터 값에 대해 `Vector3`과 `FastVector3` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 `FastVector3`을 사용하는 방법과 월드 최적화에 활용하는 방법에 대해 알아봅시다. # Fast 타입 `FastVector2`, `FastVector3`, `FastColor` 타입은 Lua Table로 작성되어 기존의 `Vector2`, `Vector3`, `Color`를 보완할 수 있습니다 .두 종류의 타입 모두 같은 기능을 제공하지만, Fast 접두사가 붙은 타입은 월드에 부하가 발생할 때 최적화 용도로 사용할 수 있습니다. # FastVector3 특징 FastVector3의 5가지 특징은

[task] | single_turn [pass] | ⏳ 미판정 [title] | FastVector3을 활용한 월드 최적화 [question] | FastVector3의 Static 프로퍼티(예: zero)를 사용할 때 Clone()을 반드시 호출해야 하는 이유는 무엇인가요? [answer] | `FastVector3`의 Static 프로퍼티(예: `FastVector3.zero`)에 접근할 때 `Clone()`을 반드시 호출해야 하는 이유는 **원본의 참조를 반환하기 때문**입니다. `FastVector3`은 Static 프로퍼티에 접근하면 해당 Static 프로퍼티 자체의 값을 직접 참조하게 됩니다. 따라서 `Clone()` 없이 Static 프로퍼티를 복사한 변수에 값을 대입하면, 그 변경 사항은 원래의 Static 프로퍼티(`FastVector3.zero` 등)에도 즉시 반영되어 값이 영구적으로 변경됩니다. 반면 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 `FastVector3`을 사용하는 방법과 월드 최적화에 활용하는 방법에 대해 알아봅시다. # Fast 타입 `FastVector2`, `FastVector3`, `FastColor` 타입은 Lua Table로 작성되어 기존의 `Vector2`, `Vector3`, `Color`를 보완할 수 있습니다 .두 종류의 타입 모두 같은 기능을 제공하지만, Fast 접두사가 붙은 타입은 월드에 부하가 발생할 때 최적화 용도로 사용할 수 있습니다. # FastVector3 특징 FastVector3의 5가지 특징은

[task] | single_turn [pass] | ⏳ 미판정 [title] | FastVector3을 활용한 월드 최적화 [question] | FastVector3을 프로퍼티나 함수 매개변수로 직접 선언하려고 하면 에러가 나는 이유가 무엇인가요? [answer] | `FastVector3`은 프로퍼티 타입이나 함수의 매개변수로 직접 지정할 수 없습니다. 이는 `FastVector3`이 mLua에서 네이티브(Native) 참조 타입으로 처리되도록 설계되어 있기 때문입니다. 따라서 `FastVector3`을 프로퍼티나 매개변수로 사용해야 하는 상황에서는 **`any`** 또는 **`table`** 타입을 사용해야 합니다. 특히 mLua에서는 `any` 타입을 사용하고, 코드의 가독성과 정적 분석을 위해 어노테이션(Annotation)을 함께 사용하는 것을 권장합니다. 다음은 `FastVecto [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `FastVector3`은 **프로퍼티 타입, 함수의 매개변수**로 지정할 수 없습니다. 그러므로 `FastVector3`을 타입이나 매개 변수로 사용할 때는 **any, table** 타입을 사용해야 합니다. 특히 **mLua**를 사용할 때는 **any** 타입을 사용하고, 어노테이션(Annotation)을 함께 사용하기를 권장합니다. ```lua ---@type FastVector3 property any vt = FastVector3(0,0,0) ---@param vt FastVector3 method void NewM

[task] | instruction_following [pass] | ⏳ 미판정 [title] | 로컬화된 Entity [question] | 로컬화된 엔티티의 4가지 유의사항을 번호 매긴 목록으로만 정리하세요. [answer] | 1. **부모-자식** 관계에 영향을 받습니다. 부모 엔티티를 로컬화된 엔티티로 변경하면 자식 엔티티 모두 동일하게 변경됩니다. 2. **서버 실행제어 함수**를 사용할 수 없습니다. 3. 서버에서 검증 작업을 할 수 없으므로 변조, 해킹에 취약합니다. 월드 생태계에서 중요한 역할을 하는 엔티티의 경우 로컬화된 엔티티로 사용하지 않도록 주의해야 합니다. 4. **PortalComponent**의 경우 로컬화된 엔티티에서 사용할 수 없습니다. 또한 서버 기능을 사용하는 컴포넌트의 경우 일부 기능이 정상적으로 동작하지 않을 수 있습니다 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 클라이언트에서만 생성되는 로컬화된 엔티티에 대해 알아봅시다. ##### 참고 가이드 [서버와 클라이언트](/docs?postId=207) [예시로 알아보는 서버 검증](/docs?postId=1084) [패킷 변조 대비하기](/docs?postId=1102) [Effective MSW 2](/docs/?postId=560) # 로컬화된 엔티티 **로컬화된 엔티티(Localized Entity)**란 클라이언트에서만 생성되는 엔티티를 의미합니다. Hierarchy 창에서는 ![[object Object]]

[task] | single_turn [pass] | ⏳ 미판정 [title] | FastVector3을 활용한 월드 최적화 [question] | mLua에서 FastVector3 타입을 안전하게 다루기 위해 권장하는 어노테이션(Annotation) 작성 방법은 어떻게 되나요? [answer] | mLua에서 `FastVector3`은 프로퍼티 타입이나 함수의 매개변수 타입으로 직접 지정할 수 없습니다. 따라서 안전하게 다루기 위해 **`any` 타입**을 사용하고, **어노테이션(Annotation)** 으로 실제 타입이 `FastVector3`임을 명시하는 것이 권장됩니다. 구체적인 작성 방법은 다음과 같습니다. 1. **프로퍼티 선언 시**: 프로퍼티 값을 `any` 타입으로 선언하고, 선언부 위에 `---@type FastVector3` 어노테이션을 붙입니다. 2. **함수 매개변수 선언 시**: 매개변수를 ` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `FastVector3`은 **프로퍼티 타입, 함수의 매개변수**로 지정할 수 없습니다. 그러므로 `FastVector3`을 타입이나 매개 변수로 사용할 때는 **any, table** 타입을 사용해야 합니다. 특히 **mLua**를 사용할 때는 **any** 타입을 사용하고, 어노테이션(Annotation)을 함께 사용하기를 권장합니다. ```lua ---@type FastVector3 property any vt = FastVector3(0,0,0) ---@param vt FastVector3 method void NewM

[task] | single_turn [pass] | ⏳ 미판정 [title] | mLua [question] | @MinValue와 @MaxValue 어트리뷰트를 number 타입 프로퍼티에 사용하려고 하는데, 두 어트리뷰트를 동시에 적용했을 때 값 범위가 어떻게 제한되는지 그리고 범위를 벗어나면 어떻게 동작하는지 알고 싶습니다. [answer] | 제공된 문서에 따르면, `@MinValue`와 `@MaxValue` 어트리뷰트는 `number` 또는 `integer` 타입의 프로퍼티에 적용 가능하며, 각각 프로퍼티 에디터에서 사용할 수 있는 최솟값과 최댓값을 지정합니다. 두 어트리뷰트를 동시에 적용할 경우, 해당 프로퍼티의 값은 `@MinValue`로 지정된 값 이상이고 `@MaxValue`로 지정된 값 이하인 범위 내에서만 유효합니다. 단, **범위를 벗어나는 값을 입력했을 때의 구체적인 동작(예: 입력 자체 차단, 경계값으로 자동 보정, 오류 메시지 출력 등)에 대해서는 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 메소드와 이벤트 핸들러의 실행제어 공간을 지정합니다. 파라미터는 string으로 지정된 문자열로만 사용이 가능합니다. 적용 대상은 **메소드, 이벤트 핸들러**입니다. 적용 가능 타입은 **Component, Logic**입니다. * 매개 변수: **string** ("Server", "Client", "ServerOnly", "ClientOnly", "Multicast") ```lua @ExecSpace("Client") @ExecSpace("Server") @ExecSpace("ServerOnly") @ExecSpace("C

[task] | two_turn [pass] | ⏳ 미판정 [title] | FastVector3을 활용한 월드 최적화 [question] | FastVector3에서 x, y, z 값을 인덱스로 접근할 때 각각 어떤 숫자에 대응하나요? [answer] | `FastVector3`에서 인덱스를 이용해 값을 접근할 때 각 인덱스는 다음과 같이 대응됩니다. * **1**: x * **2**: y * **3**: z 즉, `v[1]`은 x 값, `v[2]`는 y 값, `v[3]`은 z 값을 반환합니다. ```lua local v = FastVector3(1, 2, 3) print(v.x, v.y, v.z) -- Output: 1 2 3 print (v[1], v[2], v[3]) -- Output: 1 2 3 ``` [followup] | 인덱스 접근 방식이 가독성을 해친다는 점을 고려할 때, 실제로 이 방식을 적용해야 하는 최적화가 필요한 상황의 기준은 무엇인가요? [followup_answer] | 인덱스 접근 방식은 가독성이 낮으므로, 월드에 **최대한의 최적화가 필요한 상황**에서만 사용해야 합니다. 구체적인 기준으로는 `Normalize()` 함수 호출 빈도가 지나치게 높은 경우를 들 수 있습니다. 이러한 경우 인덱스 접근을 적용하면 성능을 개선할 수 있습니다. [scores] | [judge_reason] | [source_doc] | `FastVector3`은 인덱스를 이용해 접근할 수도 있습니다. 아래 표를 보면 인덱스를 이용한 접근이 키를 이용한 접근보다 약간 더 빠른 것을 알 수 있습니다. ![[object Object]](https://mod-file.dn.nexoncdn.co.kr/bbs/17453667314987383595f55d84737a7cb12f62068050b.png{"width":"1080px"} "FastVector3Index") 인덱스를 이용해 `FastVector3`에 접근하는 예제는 아래와 같습니다. x는 1, y는 2, z는 3에

[task] | code [pass] | ⏳ 미판정 [title] | VS Code: mLua Extension [question] | VS Code mLua Extension의 Entity Id Completion 기능을 활용해 BackgroundComponent 타입 프로퍼티에 엔티티 경로를 입력하고 자동 완성으로 Id를 치환하는 스크립트를 작성해줘 [answer] | VS Code의 mLua Extension에서 Entity Id Completion 기능을 사용하는 방법은 다음과 같습니다. 1. **프로퍼티 선언**: `BackgroundComponent` 타입의 프로퍼티를 정의합니다. 2. **경로 입력**: 해당 프로퍼티 값으로 엔티티 경로(예: `/maps/map01/Background`)를 입력합니다. 3. **자동 완성(Completion) 트리거**: 커서를 엔티티 경로 문자열 안에 위치시킵니다. mLua Extension은 해당 경로가 가리키는 엔티티를 분석하여, 프로퍼티 타 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 스크립트 작성 시 특정 스크립트에 사용 가능한 심볼을 추론하고, 자동 완성을 제공합니다. 인덱싱할 때도 해당 심볼로부터 접근 가능한 멤버를 추론하고, 자동 완성을 제공합니다. ![[object Object]](https://mod-file.dn.nexoncdn.co.kr/bbs/173925981885800cc64e8e22a4c6bab618d241f270495.png{"width":"430px"} "123") #### Entity Id Completion 엔티티 경로를 이용해서 엔티티의 Id를 쉽게 찾을 수 있습니다. Compl

[task] | instruction_following [pass] | ⏳ 미판정 [title] | FastVector3을 활용한 월드 최적화 [question] | 문서 내 `Normalize` 함수 재정의 예제를 코드만 출력하고, 각 단계별 처리 로직은 주석으로만 설명해 주세요. [answer] | ```lua local v3mt = getmetatable(FastVector3.zero) -- FastVector3의 Normalize 함수를 수정 v3mt.Normalize = function(self) -- 벡터의 x, y, z 값을 인덱스(1, 2, 3)를 통해 추출합니다. local x, y, z = self[1], self[2], self[3] -- 벡터의 길이를 계산합니다. (피타고라스 정리: 루트(x^2 + y^2 + z^2)) local length = (x*x + y*y + [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `FastVector3`은 인덱스를 이용해 접근할 수도 있습니다. 아래 표를 보면 인덱스를 이용한 접근이 키를 이용한 접근보다 약간 더 빠른 것을 알 수 있습니다. ![[object Object]](https://mod-file.dn.nexoncdn.co.kr/bbs/17453667314987383595f55d84737a7cb12f62068050b.png{"width":"1080px"} "FastVector3Index") 인덱스를 이용해 `FastVector3`에 접근하는 예제는 아래와 같습니다. x는 1, y는 2, z는 3에

[task] | single_turn [pass] | ⏳ 미판정 [title] | 비정상 거래 대응 가이드 [question] | 월드 내 거래소를 만들었는데, 특정 아이템을 현금으로 바꾸려는 플레이어를 막기 위해 mLua 스크립트로 어떤 조건을 걸어야 하나요? [answer] | 제공된 참고 문서에는 mLua 스크립트 코드의 구체적인 문법이나 API(예: 아이템 ID 조회, 인벤토리 조작, 현금 결제 API 등)가 포함되어 있지 않습니다. 문서에는 비정상 거래를 막기 위한 **기획 단계의 조건 설정 예시**만 제시되어 있으며, 이를 mLua 코드로 변환할 수 있는 실제 API 명세는 없습니다. 따라서 요청하신 mLua 스크립트 코드를 정확히 작성하는 것은 불가능합니다. 다만, 문서에 제시된 **비정상 거래 사전 예방을 위한 조건 설정 가이드**는 다음과 같습니다. 이 조건들을 구현하려면 해당 조건을 확인 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 월드가 성장하고 다수의 유료 상품이 추가되면 더욱 다양한 형태의 거래 및 결제 행위가 발생할 수 있으며 이러한 거래 행위가 올바르게 관리될 수 있도록 본 가이드를 마련하였습니다. 비정상 거래로 인한 피해로부터 크리에이터님의 콘텐츠를 보호할 수 있도록 안내드리는 가이드에 맞춰 사전 예방하시는 것을 권장해 드립니다. # 비정상 거래 대응의 필요성 크리에이터는 크리에이터가 제작한 월드에서 운영정책 위반 행위가 발생하지 않도록 플레이어 간의 거래 방식과 거래 시스템에 대해 긴밀한 관리가 필요합니다. * 플랫폼에서 금지하고 있는 비정상

[task] | single_turn [pass] | ⏳ 미판정 [title] | FastVector3을 활용한 월드 최적화 [question] | FastVector3은 왜 Vector3보다 부하가 적게 걸리며, 어떤 상황에서 치환하는 것이 유리한가요? [answer] | `FastVector3`은 `Vector3`보다 부하가 적게 걸리는 이유는 **Lua Table로 구현**되어 있기 때문입니다. 기존에 네이티브 타입으로 구현된 `Vector3`에 비해 가볍고 유연한 구조를 가지며, 연산이 많아질수록 두 타입 간의 성능 차이가 커집니다. 또한 `FastVector3`은 8 Byte 실수형 값을 사용하고 `Vector3`은 4 Byte 실수형을 사용하므로, 두 타입 사이의 유효 범위와 연산 결과는 차이가 발생할 수 있습니다. 치환하는 것이 유리한 상황은 다음과 같습니다: 1. **월드 부하가 발생 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 `FastVector3`을 사용하는 방법과 월드 최적화에 활용하는 방법에 대해 알아봅시다. # Fast 타입 `FastVector2`, `FastVector3`, `FastColor` 타입은 Lua Table로 작성되어 기존의 `Vector2`, `Vector3`, `Color`를 보완할 수 있습니다 .두 종류의 타입 모두 같은 기능을 제공하지만, Fast 접두사가 붙은 타입은 월드에 부하가 발생할 때 최적화 용도로 사용할 수 있습니다. # FastVector3 특징 FastVector3의 5가지 특징은

[task] | single_turn [pass] | ⏳ 미판정 [title] | FastVector3을 활용한 월드 최적화 [question] | FastVector3을 효율적으로 사용하여 참조 객체 생성을 줄이는 구체적인 사용법은 무엇인가요? [answer] | FastVector3은 프로퍼티 타입이나 함수 매개변수로 직접 지정할 수 없으므로, 참조 객체 생성을 줄이기 위해서는 `any` 타입을 사용하여 어노테이션(Annotation)을 함께 붙여주는 방식으로 선언해야 합니다. 구체적인 사용법은 다음과 같습니다. ```lua ---@type FastVector3 property any vt = FastVector3(0,0,0) ---@param vt FastVector3 method void NewMethod(any vt) -- ... end ``` 이처럼 `any` 타입으로 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | `FastVector3`은 **프로퍼티 타입, 함수의 매개변수**로 지정할 수 없습니다. 그러므로 `FastVector3`을 타입이나 매개 변수로 사용할 때는 **any, table** 타입을 사용해야 합니다. 특히 **mLua**를 사용할 때는 **any** 타입을 사용하고, 어노테이션(Annotation)을 함께 사용하기를 권장합니다. ```lua ---@type FastVector3 property any vt = FastVector3(0,0,0) ---@param vt FastVector3 method void NewM

[task] | code [pass] | ⏳ 미판정 [title] | mLua [question] | `---@sealed` 어노테이션을 메서드 정의문에 붙여 오버라이드를 방지하고, `---@description "Player Speed Control"` 설명을 추가한 `number` 타입 프로퍼티를 함께 정의하는 스크립트를 작성해줘 [answer] | 요청하신 `---@sealed` 어노테이션과 `---@description` 설명이 포함된 `number` 타입 프로퍼티, 그리고 오버라이드가 방지된 메서드를 정의하는 mLua 스크립트는 다음과 같습니다. ```lua Property: ---@description "Player Speed Control" number PlayerSpeed = 10 Method: ---@sealed void UpdatePlayerSpeed() { -- 메서드 본문 self.PlayerSpeed = 15 } ``` [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | Return Annotation은 대상 함수의 반환 타입을 지정할 수 있습니다. 함수 정의문, 메소드 정의문에 사용할 수 있습니다. Return Annotation은 대상 함수의 반환 타입을 지정하여 스크립트 어시스트의 도움을 받을 수 있습니다. ```lua ---@return TYPE ``` **사용 예시** ```lua ---@return Entity local function TestFunction(testParamA, testParamB) return self.Entity end ``` ```lua ---@retu

[task] | single_turn [pass] | ⏳ 미판정 [title] | mLua [question] | @HideFromInspector 어트리뷰트는 프로퍼티를 프로퍼티 에디터에서 숨기는 용도인데, @DisplayName이나 @Description처럼 매개변수를 받지 않는 형태인 이유는 무엇인가요? [answer] | `@HideFromInspector` 어트리뷰트가 매개변수를 받지 않는 이유는, 이 어트리뷰트가 **값(매개변수)에 따라 동작이 변하는 것이 아니라 존재 여부만으로 동작을 결정하는 "부울(Bool)형 플래그"**이기 때문입니다. * **`@DisplayName`과 `@Description`**: 프로퍼티 에디터에 표시할 **문자열 값**을 지정해야 하므로, 반드시 매개변수로 문자열을 받아야 합니다. * **`@HideFromInspector`**: "숨기겠다"는 의지만 표현하면 되므로, 특정 값을 전달할 필요가 없습니다. [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | 메소드와 이벤트 핸들러의 실행제어 공간을 지정합니다. 파라미터는 string으로 지정된 문자열로만 사용이 가능합니다. 적용 대상은 **메소드, 이벤트 핸들러**입니다. 적용 가능 타입은 **Component, Logic**입니다. * 매개 변수: **string** ("Server", "Client", "ServerOnly", "ClientOnly", "Multicast") ```lua @ExecSpace("Client") @ExecSpace("Server") @ExecSpace("ServerOnly") @ExecSpace("C

[task] | two_turn [pass] | ⏳ 미판정 [title] | FastVector3을 활용한 월드 최적화 [question] | FastVector3의 인덱스 접근과 키 접근 중 어떤 방식이 성능에 더 유리한가요? [answer] | `FastVector3`의 인덱스 접근(`v[1]`, `v[2]`, `v[3]`)은 키 접근(`v.x`, `v.y`, `v.z`)보다 성능 측면에서 약간 더 유리합니다. 다만, 인덱스 접근은 가독성이 떨어지기 때문에 일반적인 상황에서는 `x`, `y`, `z` 멤버를 직접 사용하는 키 접근을 권장하며, 월드에 최대한의 최적화가 필요한 상황(예: `Normalize()` 함수 호출 빈도가 지나치게 높은 경우)에서만 인덱스 접근을 사용하는 것이 좋습니다. ```lua local v = FastVector3(1, 2, 3) print [followup] | Normalize() 함수 호출 빈도가 높은 상황에서 인덱스 접근을 적용해 성능을 개선하는 구체적인 코드 예시를 보여주세요. [followup_answer] | `Normalize()` 함수 호출 빈도가 높은 상황에서 성능을 개선하기 위해 메타테이블의 `Normalize` 함수를 인덱스 접근 방식으로 재정의하는 예제는 다음과 같습니다. ```lua local v3mt = getmetatable(FastVector3.zero) -- FastVector3의 Normalize 함수를 수정 v3mt.Normalize = function(self) local x, y, z = self[1], self[2], self[3] -- self.x , self.y , self.z loca [scores] | [judge_reason] | [source_doc] | `FastVector3`은 인덱스를 이용해 접근할 수도 있습니다. 아래 표를 보면 인덱스를 이용한 접근이 키를 이용한 접근보다 약간 더 빠른 것을 알 수 있습니다. ![[object Object]](https://mod-file.dn.nexoncdn.co.kr/bbs/17453667314987383595f55d84737a7cb12f62068050b.png{"width":"1080px"} "FastVector3Index") 인덱스를 이용해 `FastVector3`에 접근하는 예제는 아래와 같습니다. x는 1, y는 2, z는 3에

[task] | instruction_following [pass] | ⏳ 미판정 [title] | 로컬화된 Entity [question] | 로컬화된 엔티티를 만드는 3가지 방법을 표로 정리하세요. [answer] | 로컬화된 엔티티를 만드는 3가지 방법은 다음과 같습니다. | 방법 | 설명 및 사용 조건 | | :--- | :--- | | **Localize 프로퍼티 활성화** | `World` 하위에 생성한 엔티티에서만 사용 가능합니다. Hierarchy - World - maps 하위 엔티티의 프로퍼티 창 > 모델 프로퍼티에서 `Localize`를 활성화하면, Scene에 직접 배치한 엔티티라도 클라이언트에서만 생성됩니다. | | **UI 엔티티로 생성** | `ui - UI Group`에 생성되는 UI 엔티티는 기본적으로 클라이언트에서만 [followup] | [followup_answer] | [scores] | [judge_reason] | [source_doc] | # 학습 과정 소개 클라이언트에서만 생성되는 로컬화된 엔티티에 대해 알아봅시다. ##### 참고 가이드 [서버와 클라이언트](/docs?postId=207) [예시로 알아보는 서버 검증](/docs?postId=1084) [패킷 변조 대비하기](/docs?postId=1102) [Effective MSW 2](/docs/?postId=560) # 로컬화된 엔티티 **로컬화된 엔티티(Localized Entity)**란 클라이언트에서만 생성되는 엔티티를 의미합니다. Hierarchy 창에서는 ![[object Object]]

← → 방향키로 페이지 이동 · 숫자 입력 후 Enter로 점프